Vulkan 1.1 Reference Guide 


Vulkan® is a graphics and compute API consisting of procedures and 
functions to specify shader programs, compute kernels, objects, 
and operations involved in producing high-quality graphical images, 
specifically color images of three-dimensional objects. Vulkan is 
also a pipeline with programmable and state-driven fixed-function 
stages that are invoked by a set of specific drawing operations. 


Specification and additional resources at 
www.khronos.org/vulkan 


Return Codes [2.7.3] 


Return codes are reported via VkResult return values. 


Success Codes 

Success codes are non-negative. 

VK_SUCCESS VK_NOT_READY 
VK_TIMEOUT VK_EVENT_{SET, RESET} 
VK_INCOMPLETE VK_SUBOPTIMAL_KHR 


Error Codes 

Error codes are negative. 
VK_ERROR_OUT_OF_{HOST, DEVICE}_ MEMORY 
VK_ERROR_{INITIALIZATION, MEMORY_MAP}_FAILED 
VK_ERROR_DEVICE_LOST 

VK_ERROR_{EXTENSION, FEATURE, LAYER}_NOT_PRESENT 
VK_ERROR_INCOMPATIBLE_DRIVER 
VK_ERROR_TOO_MANY_OBJECTS 
VK_ERROR_FORMAT_NOT_SUPPORTED 
VK_ERROR_FRAGMENTED_POOL 
VK_ERROR_OUT_OF_POOL_MEMORY 
VK_ERROR_INVALID_EXTERNAL_HANDLE 
VK_ERROR_SURFACE_LOST_KHR 
VK_ERROR_NATIVE_WINDOW_IN_USE_KHR 
VK_ERROR_OUT_OF_DATE_KHR 
VK_ERROR_INCOMPATIBLE_DISPLAY_KHR 


Devices and Queues [4] 


Physical Devices [4.1] 

VkResult vkEnumeratePhysicalDevices( 
Vkinstance instance, 
uint32_t* pPhysicalDeviceCount, 
VkPhysicalDevice* pPhysicalDevices); 


void vkGetPhysicalDeviceProperties( 
VkPhysicalDevice physicalDevice, 
VkPhysicalDeviceProperties* pProperties); [EZ] 


void vkGetPhysicalDeviceProperties2( 
VkPhysicalDevice physicalDevice, 
VkPhysicalDeviceProperties2* pProperties); 


typedef struct VkPhysicalDeviceProperties2 { 
VkStructureType sType; [XI 
void* pNext; 
VkPhysicalDeviceProperties properties; 
} VkPhysicalDeviceProperties2; 
pNext must be NULL or point to one of: 
VkPhysicalDevicelDProperties 
VkPhysicalDeviceMaintenance3Properties 
VkPhysicalDeviceMultiviewProperties [EJ 
VkPhysicalDevicePointClippingProperties [EU] 
VkPhysicalDeviceProtectedMemoryProperties 
VkPhysicalDeviceSubgroupProperties 


void vkGetPhysicalDeviceQueueFamilyProperties( 
VkPhysicalDevice physicalDevice, 
uint32_t* pQueueFamilyPropertyCount, 
VkQueueFamilyProperties* 
pQueueFamilyProperties); 


void vkGetPhysicalDeviceQueueFamilyProperties2( 
VkPhysicalDevice physicalDevice, 
uint32_t* pQueueFamilyPropertyCount, 
VkQueueFamilyProperties2*pQueueFamilyProperties); 


typedef struct VkQueueFamilyProperties { 
VkQueueFlags queueFlags; 
uint32_t queueCount; 
uint32_t timestampValidBits; 
VkExtent3D minimageTransferGranularity; 
} VkQueueFamilyProperties; 
queueFlags: 
VK_QUEUE_X_BIT where X is GRAPHICS, COMPUTE, 
TRANSFER, PROTECTED, SPARSE_BINDING 


typedef struct VkQueueFamilyProperties2 { 
VkStructureType sType; [EU] 
void* pNext; VkQueueFamilyProperties 
queueFamilyProperties; 
} VkQueueFamilyProperties2; 
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Vu an. 


Color coded names as follows: function names and structure names 
[n.n.n] Indicates sections and text in the Vulkan API 1.1 Specification. 
[E23 Indicates a page in this reference guide for more information. 


KHROONOS 


GROUP 


ET Indicates reserved for future use. 
pNext must either be NULL, or point to a valid structure which extends the base 
structure according to the valid usage rules of the base structure. 


Command Function Pointers and Instances [3] 


Command Function Pointers [3.1] 
PFN_vkVoidFunction vkGetInstanceProcAddr( 
Vkinstance instance, const char* pName); 


PFN_vkVoidFunction vkGetDeviceProcAddr( 
VkDevice device, const char* pName); 
PFN_vkVoidFunction is: 
typedef void(VKAPI_PTR* PFN_vkVoidFunction)(void); 


Instances [3.2] 
VkResult vkEnumeratelnstanceVersion( 
uint32_t* pApiVersion); 


VkResult vkCreatelnstance( 
const VkinstanceCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, EA 
Vkinstance* pinstance); 


typedef struct VkinstanceCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkinstanceCreateFlags flags; EX 
const VkApplicationinfo* pApplicationinfo; 
uint32_t enabledLayerCount; 
const char* const* ppEnabledLayerNames; 
uint32_t enabledExtensionCount; 


Devices [4.2] 
VkResult vkEnumeratePhysicalDeviceGroups( 
Vkinstance instance, 
uint32_t* pPhysicalDeviceGroupCount, 
VkPhysicalDeviceGroupProperties* 
pPhysicalDeviceGroupProperties); 


typedef struct VkPhysicalDeviceGroupProperties { 
VkStructureType sType; 
void* pNext; 
uint32_t physicalDeviceCount; 
VkPhysicalDevice physicalDevices[ 

VK_MAX_DEVICE_GROUP_SIZE]; 

VkBool32 subsetAllocation; 

} VkPhysicalDeviceGroupProperties; 


Device Creation [4.2.1] 
VkResult vkCreateDevice( 
VkPhysicalDevice physicalDevice, 
const VkDeviceCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, EA 
VkDevice* pDevice); 


typedef struct VkDeviceCreatelnfo { 

VkStructureType sType; 

const void* pNext; 

VkDeviceCreateFlags flags; EX 

uint32_t queueCreatelnfoCount; 

const VkDeviceQueueCreatelnfo* pQueueCreatelnfos; 

uint32_t enabledLayerCount; 

const char* const* ppEnabledLayerNames; 

uint32_t enabledExtensionCount; 

const char* const* ppEnabledExtensionNames; 

const VkPhysicalDeviceFeatures* pEnabledFeatures; [XU] 

} VkDeviceCreatelnfo; 
pNext must be NULL or point to one of: 

VkDeviceGroupDeviceCreatelnfo 
VkPhysicalDevice16BitStorageFeatures 
VkPhysicalDeviceFeatures2 [EU] 
VkPhysicalDeviceMultiviewFeatures 
VkPhysicalDeviceProtectedMemoryFeatures [EE] 
VkPhysicalDeviceSamplerYcbcrConversionFeatures 
VkPhysicalDeviceVariablePointerFeatures 


typedef struct VkDeviceGroupDeviceCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
uint32_t physicalDeviceCount; 
const VkPhysicalDevice* pPhysicalDevices; 
} VkDeviceGroupDeviceCreatelnfo; 


Device Destruction [4.2.4] 
void vkDestroyDevice( 
VkDevice device, 
const VkAllocationCallbacks* pAllocator); 


const char* const* ppEnabledExtensionNames; 
}VkinstanceCreatelnfo; 


typedef struct VkApplicationinfo { 
VkStructureType sType; 2H 
const void* pNext; 
const char* pApplicationName; 
uint32_t applicationVersion; 
const char* pEngineName; 
uint32_t engineVersion; 
uint32_t apiVersion; 

} VkApplication|nfo; 


void vkDestroyInstance( 
Vkinstance instance, 
const VkAllocationCallbacks* pAllocator); EA 


Queues [4.3] 
typedef struct VkDeviceQueueCreatelnfo { 
VkStructureType sType; [Ze] 
const void* pNext; 
VkDeviceQueueCreateFlags flags; 
uint32_t queueFamilylndex; 
uint32_t queueCount; 
const float* pQueuePriorities; 
} VkDeviceQueueCreatelnfo; 
flags: VK_DEVICE_QUEUE_CREATE_PROTECTED_BIT 


void vkGetDeviceQueue(VkDevice device, 
uint32_t queueFamilyindex, uint32_t queuelndex, 
VkQueue* pQueue); 


void vkGetDeviceQueue2(VkDevice device, 
const VkDeviceQueuelnfo2* pQueuelnfo, 
VkQueue* pQueue); 


typedef struct VkDeviceQueuelnfo2 { 
VkStructureType sType; EA 
const void* pNext; 
VkDeviceQueueCreateFlags flags; 
uint32_t queueFamilyindex; uint32_t queuelndex; 
} VkDeviceQueuelnfo2; 


flags: VK_DEVICE_QUEUE_CREATE_PROTECTED_BIT 


Command Buffers [5] 
Also see Command Buffer Lifecycle diagram. EX] 


Command Pools [5.2] 

VkResult vkCreateCommandPool( 
VkDevice device, 
const VkCommandPoolCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, [XF] 
VkCommandPool* pCommandPool); 


typedef struct VkCommandPoolCreatelnfo { 
VkStructureType sType; ZE 
const void* pNext; 
VkCommandPoolCreateFlags flags; 
uint32_t queueFamilylndex; 
}VkCommandPoolCreatelnfo; 
flags: VK_COMMAND_POOL_CREATE_X_BIT where X is 
PROTECTED, RESET_COMMAND_BUFFER, TRANSIENT 


void vkTrimCommandPool(VkDevice device, 
VkCommandPool commandPool, 
VkCommandPoolTrimFlags flags); ET 


VkResult vkResetCommandPool( 
VkDevice device, VkCommandPool commandPool, 
VkCommandPoolResetFlags flags); 
flags: VK_COMMAND_POOL_RESET_RELEASE_- 
RESOURCES_BIT 


void vkDestroyCommandPool( 
VkDevice device, VkCommandPool commandPool, 
const VkAllocationCallbacks* pAllocator); EA 


Continued on next page > 


www.khronos.org/vulkan 


Vulkan 1.1 Reference Guide 


Command Buffers (continued) 


Command Buffer Lifetime [5.3] 

VkResult vkAllocateCommandBuffers( 
VkDevice device, 
const VkCommandBufferAllocatelnfo* pAllocatelnfo, 
VkCommandBuffer* pCommanaBuffers); 


typedef struct VkCommandBufferAllocatelnfo{ 
VkStructureType sType; BH 
const void* pNext; 
VkCommandPool commandPool; 
VkCommandBufferLevel level: 
uint32_t commandBufferCount; 
}VkCommandBufferAllocatelnfo; 


level: 


VK_COMMAND_BUFFER_LEVEL_{PRIMARY, SECONDARY} 


VkResult vkResetCommandBuffer( 
VkCommandBuffer commandBuffer, 
VkCommandBufferResetFlags flags); 


flags: 


VK_ COMMAND_BUFFER_RESET_RELEASE RESOURCES. BIT 


void vkFreeCommandBuffers| 
VkDevice device, VkCommandPool commandPool, 
uint32_t commandBufferCount, 
const VkCommandBuffer* pCommanaBuffers); 


Command Buffer Recording [5.4] 

VkResult vkBeginCommandBuffer( 
VkCommandBuffer commandBuffer, 
const VkCommandBufferBegininfo* pBegininfo); 


typedef struct VkCommandBufferBegininfo{ 
VkStructureType sType; BA 
const void* pNext; 
VkCommandBufferUsageFlags flags; 


const VkCommandBufferinheritancelnfo* pinheritancelnfo; 


}VkCommandBufferBegininfo; 


flags: VK_COMMAND_BUFFER_USAGE_X _BIT where X is 


ONE_TIME_SUBMIT, RENDER_PASS_CONTINUE, 
SIMULTANEOUS_USE 

pNext must be NULL or point to: 
VkDeviceGroupCommandBufferBegininfo [ÆA 


Synchronization and Cache Control [6] 


Fences [6.3] 
Fence status is always either signaled or unsignaled. 


VkResult vkCreateFence( 


VkDevice device, const VkFenceCreatelnfo* pCreatelnfo, 


const VkAllocationCallbacks* pAllocator, 
VkFence* pFence); 


typedef struct VkFenceCreatelnfo { 
VkStructureType sType; BA 
const void* pNext; 
VkFenceCreateFlags flags; 
} VkFenceCreatelnfo; 
flags: VK_FENCE_CREATE_SIGNALED_BIT 


pNext must be NULL or point to: 
VkExportFenceCreatelnfo [XF 


void vkDestroyFence( 
VkDevice device, VkFence fence, 
const VkAllocationCallbacks* pAllocator); 


VkResult vkGetFenceStatus( 
VkDevice device, VkFence fence); 


VkResult vkResetFences(VkDevice device, 
uint32_t fenceCount, const VkFence* pFences); 


VkResult vkWaitForFences(VkDevice device, 
uint32_t fenceCount, const VkFence* pFences, 
VkBool32 waitAll, uint64_t timeout); 


Semaphores [6.4] 
Semaphore status is always either signaled or unsignaled. 


VkResult vkCreateSemaphore( 
VkDevice device, 
const VkSemaphoreCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, EA 
VkSemaphore* pSemaphore); 


typedef struct VkSemaphoreCreatelnfo { 
VkStructureType sType; BA 
const void* pNext; 
VkSemaphoreCreateFlags flags; E 
} VkSemaphoreCreatelnfo; 
pNext must be NULL or point to: 
VkExportSemaphoreCreatelnfo 
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typedef struct VkCommandBufferinheritancelnfo { 
VkStructureType sType; 
const void* pNext; 
VkRenderPass renderPass; 
uint32_t subpass; 
VkFramebuffer framebuffer; 
VkBool32 occlusionQueryEnable; 
VkQueryControlFlags queryFlags; 
VkQueryPipelineStatisticFlags pipelineStatistics; [ZU] 
} VkCommandBufferInheritancelnfo; 


queryFlags: VK_QUERY_CONTROL_PRECISE_BIT 


VkResult vkEndCommandBuffer( 
VkCommandBuffer commandBuffer); 


Command Buffer Submission [5.5] 
VkResult vkQueueSubmit( 
VkQueue queue, uint32_t submitCount, 
const VkSubmitinfo* pSubmits, VkFence fence); 


typedef struct VkSubmitinfo{ 
VkStructureType sType; 
const void* pNext; 
uint32_t waitSemaphoreCount; 
const VkSemaphore* pWaitSemaphores; 
const VkPipelineStageFlags* pWaitDstStageMask; 
uint32_t commandBufferCount; 
const VkCommandBuffer* pCommandBuffers; 
uint32_t signalSemaphoreCount; 
const VkSemaphore* pSignalSemaphores; 
} VkSubmitInfo; 
pNext must be NULL or point to one of: 
VkDeviceGroupSubmitInfo 
VkProtectedSubmitinfo 


Secondary Command Buffer Execution [5.7] 
void vkCmdExecuteCommands( 
VkCommandBuffer commandBuffer, 
uint32_t commandBufferCount, 
const VkCommandBuffer* pCommanaBuffers); 


Command Buffer Device Mask [5.8] 

void vkCmdSetDeviceMask( 
VkCommandBuffer commanaBuffer, 
uint32_t deviceMask); 


void vkDestroySemaphore( 
VkDevice device, VkSemaphore semaphore, 
const VkAllocationCallbacks* pAllocator); 


Events [6.5] 

Events represent a fine-grained synchronization primitive 
that can be used to gauge progress through a sequence of 
commands executed on a queue. 


VkResult vkCreateEvent( 


VkDevice device, const VkEventCreatelnfo* pCreatelnfo, 


const VkAllocationCallbacks* pAllocator, 
VkEvent* pEvent); 


typedef struct VkEventCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkEventCreateFlags flags; EX 
} VkEventCreatelnfo; 


void vkDestroyEvent(VkDevice device, VkEvent event, 
const VkAllocationCallbacks* pAllocator); 


VkResult vkGetEventStatus( 
VkDevice device, VkEvent event); 


VkResult vk[Set, Reset]Event( 
VkDevice device, VkEvent event); 


VkResult vkCmd[Set, Reset]Event( 
VkCommandBuffer commandBuffer, VkEvent event, 
VkPipelineStageFlags stageMask); LE 


void vkCmdWaitEvents( 

VkCommandBuffer commandBuffer, 

uint32_t eventCount, 

const VkEvent* pEvents, 

VkPipelineStageFlags srcStageMask, ZE 

VkPipelineStageFlags dstStageMask, 

uint32_t memoryBarrierCount, 

const VkMemoryBarrier* pMemoryBarriers, LE] 

uint32_t bufferMemoryBarrierCount, 

const VkBufferMemoryBarrier* 
pBufferMemoryBarriers, 

uint32_t imageMemoryBarrierCount, 

const VkimageMemoryBarrier* 
plmageMemoryBarriers); E€ 


Version Number Macros [Appendix D] 
The vulkan.h header defines C preprocessor macros that are 
described below. Version numbers are packed into integers. 


#define VK_VERSION_MAJOR(version) \ 
((uint32_t)(version) >> 22) 

#define VK_VERSION_MINOR(version) \ 
(((uint32_t)(version) >> 12) & Ox3ff) 


#define VK_VERSION_PATCH(version) \ 
((uint32_t)(version) & Oxfff) 


#define VK_API_VERSION_1_0 VK_MAKE_VERSION(1, 0, 0) 
#define VK_API_VERSION_1_1 VK_MAKE_VERSION(1, 1, 0) 
#define VK_MAKE_VERSION(major, minor, patch) \ 
(((major) << 22) | ((minor) << 12) | (patch)) 
major: the major version number 
minor: the minor version number 
patch: the patch version number 


#define VK_HEADER_VERSION patch-version 


patch-version: synchronized with the patch version of the 
released specification 


VK_NULL_HANDLE 

This is a canonical invalid non-dispatchable handle. It is 
returned by certain object creation functions if creation fails, 
and can be passed as a parameter where permitted by VU 
rules. 


Pipeline Barriers [6.6] 
void vkCmdPipelineBarrier( 
VkCommandBuffer commandBuffer, 
VkPipelineStageFlags srcStageMask, ZH 
VkPipelineStageFlags dstStageMask, EE 
VkDependencyFlags dependencyFlags, 
uint32_t memoryBarrierCount, 
const VkMemoryBarrier* pMemoryBarriers, 
uint32_t bufferMemoryBarrierCount, 
const VkBufferMemoryBarrier* 
pBufferMemoryBarriers, EA 
uint32_t imageMemoryBarrierCount, 
const VklmageMemoryBarrier* 
plmageMemoryBarriers); [XE] 


Wait Idle Operations [6.8] 
VkResult vkQueueWaitidle(VkQueue queue); 


VkResult vkDeviceWaitldle(VkDevice device); 
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Render Pass [7] 

A render pass represents a collection of attachments, 
subpasses, and dependencies between the subpasses, and 
describes how the attachments are used over the course of 
the subpasses. 


Render Pass Creation [7.1] 

VkResult vkCreateRenderPass(VkDevice device, 
const VkRenderPassCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, ŒA 
VkRenderPass* pRenderPass); 


typedef struct VkRenderPassCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkRenderPassCreateFlags flags; EX 
uint32_t attachmentCount; 
const VkAttachmentDescription* pAttachments; 
uint32_t subpassCount; 
const VkSubpassDescription* pSubpasses; 
uint32_t dependencyCount; 
const VkSubpassDependency* pDependencies; 
}VkRenderPassCreatelnfo; 


pNext must be NULL or point to one of: 


VkRenderPassInputAttachmentAspectCreatelnfo 


VkRenderPassMultiviewCreatelnfo [ET 


typedef struct VkAttachmentDescription { 
VkAttachmentDescriptionFlags flags; 
VkFormat format; EE 
VkSampleCountFlagBits samples; 
VkAttachmentLoadOp loadOp; 
VkAttachmentStoreOp storeOp; 
VkAttachmentLoadOp stencilLoadOp; 
VkAttachmentStoreOp stencilStoreOp; 
VklmageLayout initialLayout; LE] 
VkImageLayout finalLayout; 

} VkAttachmentDescription; 


flags: VK_ATTACHMENT_DESCRIPTION_MAY_ALIAS_ BIT 


loadOp, stencilLoadOp: VK_ATTACHMENT_LOAD_OP_X 
where X is LOAD, CLEAR, DONT_CARE 


storeOp, stencilStoreOp: VK_ATTACHMENT_STORE_OP_X 


where X is STORE, DONT_CARE 


typedef struct VkSubpassDescription { 
VkSubpassDescriptionFlags flags; 
VkPipelineBindPoint pipelineBindPoint; EEJ 
uint32_t inputAttachmentCount; 
const VkAttachmentReference* pinputAttachments; 
uint32_t colorAttachmentCount; 
const VkAttachmentReference* pColorAttachments; 
const VkAttachmentReference* 
pResolveAttachments; 
const VkAttachmentReference* 
pDepthStencilAttachment; 
uint32_t preserveAttachmentCount; 
const uint32_t* pPreserveAttachments; 
} VkSubpassDescription; 


typedef struct VkAttachmentReference { 
uint32_t attachment; 
VkimageLayout layout; BE 

} VkAttachmentReference; 


Pipelines [9] 


Compute Pipelines [9.1] 
Compute pipelines consist of a single static compute shader 
stage and the pipeline layout. 


VkResult vkCreateComputePipelines( 
VkDevice device, VkPipelineCache pipelineCache, 
uint32_t createlnfoCount, 
const VkComputePipelineCreatelnfo* pCreatelnfos, 
const VkAllocationCallbacks* pAllocator, LH 
VkPipeline* pPipelines); 


typedef struct VkComputePipelineCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelineCreateFlags flags; ZA 
VkPipelineShaderStageCreatelnfo stage; 2E 
VkPipelineLayout layout; 
VkPipeline basePipelineHandle; 
int32_t basePipelinelndex; 

} VkComputePipelineCreatelnfo; 


Graphics Pipelines [9.2] 

VkResult vkCreateGraphicsPipelines( 
VkDevice device, VkPipelineCache pipelineCache, 
uint32_t createlnfoCount, 
const VkGraphicsPipelineCreatelnfo* pCreatelnfos, 
const VkAllocationCallbacks* pAllocator, EA 
VkPipeline* pPipelines); 
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typedef struct VkSubpassDependency { 
uint32_t srcSubpass; 
uint32_t dstSubpass; 
VkPipelineStageFlags srcStageMask; 
VkPipelineStageFlags dstStageMask; EA 
VkAccessFlags srcAccessMask; [ZY] 
VkAccessFlags dstAccessMask; EA 
VkDependencyFlags dependencyFlags; 
} VkSubpassDependency; 


void vkDestroyRenderPass(VkDevice device, 
VkRenderPass renderPass, 
const VkAllocationCallbacks* pAllocator); 


Framebuffers [7.3] 

VkResult vkCreateFramebuffer(VkDevice device, 
const VkFramebufferCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, EA 
VkFramebuffer* pFramebuffer); 


typedef struct VkFramebufferCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkFramebufferCreateFlags flags; EX 
VkRenderPass renderPass; 
uint32_t attachmentCount; 
const VklmageView* pAttachments; 
uint32_t width; 
uint32_t height; 
uint32_t layers; 

} VkFramebufferCreatelnfo; 


void vkDestroyFramebuffer( 
VkDevice device, VkFramebuffer framebuffer, 
const VkAllocationCallbacks* pAllocator); 


Render Pass Commands [7.4] 
void vkCmdBeginRenderPass( 
VkCommandBuffer commandBuffer, 
const VkRenderPassBegininfo* pRenderPassBegin, 
VkSubpassContents contents); 
contents: VK_SUBPASS_CONTENTS_X where X is INLINE, 
SECONDARY_COMMAND_BUFFERS 


typedef struct VkRenderPassBegininfo { 

VkStructureType sType; 

const void* pNext; 

VkRenderPass renderPass; 

VkFramebuffer framebuffer; 

VkRect2D renderArea; EX 

uint32_t clearValueCount; 

const VkClearValue* pClearValues; EA 
} VkRenderPassBeginInfo; 

pNext must be NULL or point to: 
VkDeviceGroupRenderPassBeginInfo EA 


void vkGetRenderAreaGranularity( 
VkDevice device, VkRenderPass renderPass, 
VkExtent2D* pGranularity); 


void vkCmdNextSubpass( 
VkCommandBuffer commandBuffer, 
VkSubpassContents contents); 
contents: VK_SUBPASS_CONTENTS_X where X is 
INLINE, SECONDARY_COMMAND_BUFFERS 


void vkCmdEndRenderPass( 
VkCommandBuffer commandBuffer); 


In VkGraphicsPipelineCreatelnfo below, replace X with 
VkPipeline and replace Y with StateCreatelnfo. For example, 


XVertexinputŸ would be VxPipelineVertexInputStateCreatelnfo. 


typedef struct VkGraphicsPipelineCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelineCreateFlags flags; Z8 
uint32_t stageCount; 
const VkPipelineShaderStageCreatelnfo* pStages; ZA 
const XVertexInputY* pVertex/nputState; 
const XInputAssemblyY* pinputAssemblyState; 
const XTessellationY* pTessellationState; 
const XViewportY* pViewportState; 
const XRasterizationY* pRasterizationState; 
const XMultisampleY* pMultisampleState; 
const XDepthStencilY* pDepthStencilState; 
const XColorBlendY* pColorBlendState; 
const XDynamicY* pDynamicState; 
VkPipelineLayout layout; 
VkRenderPass renderPass; 
uint32_t subpass; 
VkPipeline basePipelineHandle; 
int32_t basePipelinelndex; 

} VkGraphicsPipelineCreatelnfo; 


Shaders [8] 


Shader Modules [8.1] 

VkResult vkCreateShaderModule( 
VkDevice device, 
const VkShaderModuleCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkShaderModule* pShader Module); 


typedef struct VkShaderModuleCreatelnfo { 
VkStructureType sType; 2A 
const void* pNext; 
VkShaderModuleCreateFlags flags; EX 
size_t codeSize; 
const uint32_t* pCode; 
}VkShaderModuleCreatelnfo; 


void vkDestroyShaderModule( 
VkDevice device, 
VkShaderModule shaderModule, 
const VkAllocationCallbacks* pAllocator); EA 


Built-in Variables [14.6] 
The built-in variables listed below are accessed in shaders by 
declaring the variable using a BuiltIn decoration. 


| Decoration Type 


Baselnstance Scalar 32-bit integer 

BaseVertex Scalar 32-bit integer 

ClipDistance Array of 32-bit floats 

CullDistance Array of 32-bit floats 

Devicelndex Scalar 32-bit integer 

Drawindex Scalar 32-bit integer 

FragCoord 4-component vector of 32-bit floats 
FragDepth Scalar 32-bit float 
FrontFacing Scalar 32-bit integer 
Globallnvocation|D 3-component vector of 32-bit ints 
Helperinvocation Scalar 32-bit integer 

InvocationID Scalar 32-bit integer 

Instancelndex Scalar 32-bit integer 

Layer Scalar 32-bit integer 
Locallnvocation|D 3-component vector of 32-bit ints 
NumSubgroups Scalar 32-bit integer 
NumWorkGroups 3-component vector of 32-bit ints 
PatchVertices Scalar 32-bit integer 

PointCoord 2-component vector of 32-bit floats 
PointSize Scalar 32-bit float value 


Position 4-component vector of 32-bit floats 
PrimitivelD Scalar 32-bit integer 

SamplelD Scalar 32-bit integer 

SampleMask Array of 32-bit integers 
SamplePosition 2-component vector of float values 
Subgroupld Scalar 32-bit integer 
Subgroup{Eq,Ge,Gt,Le,Lt}Mask 4-component vector of 32-bit ints 
SubgroupLocallnvocationld Scalar 32-bit integer 

SubgroupSize Scalar 32-bit integer 

TessCoord 3-component vector of 32-bit floats 
Array of size 2 of 32-bit floats 

Array of size 4 of 32-bit floats 
32-bit integer 

Scalar 32-bit integer 

32-bit integer 

3-component vector of 32-bit ints 
3-component vector of 32-bit ints 


TessLevelOuter 
TessLevellnner 
VertexIndex 
Viewindex 
Viewportindex 
WorkgroupSize 
WorkgrouplD 


typedef struct VkPipelineVertexInputStateCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelineVertexInputStateCreateFlags flags; EX 
uint32_t vertexBindingDescriptionCount; 
const VkVertexInputBindingDescription* 
pVertexBindingDescriptions; 
uint32_t vertexAttributeDescriptionCount; 
const VkVertexInputAttributeDescription* 
pVertexAttributeDescriptions; 
}VkPipelineVertexinputStateCreatelnfo; 


typedef struct VkVertexInputBindingDescription { 
uint32_t binding; 
uint32_t stride; 
VkVertexInputRate inputRate; 

} VkVertexInputBindingDescription; 


inputRate: 
VK_VERTEX_INPUT_RATE_{VERTEX, INSTANCE} 


Continued on next page > 


www.khronos.org/vulkan 


Vulkan 1.1 Reference Guide 


Pipelines (continued) 


typedef struct VkVertexInputAttributeDescription { 
uint32_t location; 
uint32_t binding; 
VkFormat format; EXE] 
uint32_t offset; 
} VkVertexInputAttributeDescription; 


typedef struct VkPipelinelnputAssemblyStateCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelinelnputAssemblyStateCreateFlags flags; EX 
VkPrimitiveTopology topology; 
VkBool32 primitiveRestartEnable; 
} VkPipelinelnputAssemblyStateCreatelnfo; 
topology: VK_PRIMITIVE_TOPOLOGY_X where X is 
POINT_LIST, LINE_LIST, LINE_STRIP, TRIANGLE_LIST, 
TRIANGLE_STRIP, TRIANGLE_FAN, 
LINE_{LIST, STRIP} WITH_ADJACENCY, 


TRIANGLE_{LIST, STRIP}_WITH_ADJACENCY, PATCH_LIST 


typedef struct VkPipelineTessellationStateCreatelnfo { 
VkStructureType sType; [==] 
const void* pNext; 
VkPipelineTessellationStateCreateFlags flags; EX 
uint32_t patchControlPoints; 

} VkPipelineTessellationStateCreatelnfo; 


pNext must be NULL or point to: 


VkPipelineTessellationDomainOriginStateCreatelnfo 


typedef struct VkPipelineViewportStateCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelineViewportStateCreateFlags flags; El 
uint32_t viewportCount; 
const VkViewport* pViewports; 
uint32_t scissorCount; 
const VkRect2D* pScissors; LE 

} VkPipelineViewportStateCreatelnfo; 


typedef struct VkPipelineRasterizationStateCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelineRasterizationStateCreateFlags flags; EX 
VkBool32 depthClampEnable; 
VkBool32 rasterizerDiscardEnable; 
VkPolygonMode polygonMode; 
VkCullModeFlags cullMode; 
VkFrontFace frontFace; 
VkBool32 depthBiasEnable; 
float depthBiasConstantFactor; 
float depthBiasClamp; 
float depthBiasSlopeFactor; 
float lineWidth; 

} VkPipelineRasterizationStateCreatelnfo; 


polygonMode: VK_POLYGON_MODE_{FILL, LINE, POINT} 


cullMode: VK_CULL_MODE_X where X is NONE, FRONT_BIT, 


BACK_BIT, FRONT_AND_BACK 
frontFace: VK_FRONT_FACE_[COUNTER_]CLOCKWISE 


Memory Allocation [10] 


Device Memory [10.2] 
Device memory is memory that is visible to the device. 


void vkGetPhysicalDeviceMemoryProperties( 
VkPhysicalDevice physicalDevice, 
VkPhysicalDeviceMemoryProperties* 
pMemoryProperties); 


void vkGetPhysicalDeviceMemoryProperties2( 
VkPhysicalDevice physicalDevice, 
VkPhysicalDeviceMemoryProperties2* 
pMemoryProperties); 


typedef struct VkPhysicalDeviceMemoryProperties2 { 
VkStructureType sType; EXT 
void* pNext; 
VkPhysicalDeviceMemoryProperties 
memoryProperties; 
} VkPhysicalDeviceMemoryProperties2; 


VkResult vkAllocateMemory( 
VkDevice device, 
const VkMemoryAllocatelnfo* pAllocatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkDeviceMemory* pMemory); 


typedef struct VkMemoryAllocatelnfo { 
VkStructureType sType; LE const void* pNext; 


VkDeviceSize* allocationSize; uint32_t memoryTypelndex; 


} VkMemoryAllocatelnfo; 
pNext must be NULL or point to one of: 
VkExportMemoryAllocatelnfo 
VkMemoryAllocateFlagsinfo [XE] 
VkMemoryDedicatedAllocatelnfo EEE] 
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typedef struct VkPipelineMultisampleStateCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelineMultisampleStateCreateFlags flags; EX 
VkSampleCountFlagBits rasterizationSamples; [AH 
VkBool32 sampleShadingEnable; 
float minSampleShading; 
const VkSampleMask* pSampleMask; 
VkBool32 alphaToCoverageEnable; 
VkBool32 alphaToOneEnable; 
}VkPipelineMultisampleStateCreatelnfo; 


typedef struct VkPipelineDepthStencilStateCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelineDepthStencilStateCreateFlags flags; E 
VkBool32 depthTestEnable; 
VkBool32 depthWriteEnable; 
VkCompareOp depthCompareOp; [24 
VkBool32 depthBoundsTestEnable; 
VkBool32 stencilTestEnable; 
VkStencilOpState front; 
VkStencilOpState back; 
float minDepthBounds; 
float maxDepthBounds; 
} VkPipelineDepthStencilStateCreatelnfo; 


typedef struct VkStencilOpState { 
VkStencilOp failOp; 
VkStencilOp passOp; 
VkStencilOp depthFailOp; 
VkCompareOp compareOp; [XA 
uint32_t compareMask; 
uint32_t writeMask; 
uint32_t reference; 

} VkStencilOpState; 


enum VkStencilOp: VK_STENCIL_OP_X where X is KEEP, 
ZERO, REPLACE, INCREMENT_AND_{CLAMP, WRAP}, 
INVERT, DECREMENT_AND_{CLAMP, WRAP} 


typedef struct VkPipelineColorBlendStateCreatelnfo { 
VkStructureType sType; IX 
const void* pNext; 
VkPipelineColorBlendStateCreateFlags flags; EX 
VkBool32 logicOpEnable; 
VkLogicOp logicOp; 
uint32_t attachmentCount; 
const VkPipelineColorBlendAttachmentState* 

pAttachments; 

float blendConstants[4]; 

} VkPipelineColorBlendStateCreatelnfo; 


logicOp: VK_LOGIC_OP_X where X is CLEAR, AND, 


AND_REVERSE, COPY, AND_INVERTED, NO_OP, XOR, OR, 


NOR, EQUIVALENT, INVERT, OR_REVERSE, 
COPY_INVERTED, OR_INVERTED, NAND, SET 

blendOp: VK_BLEND_OP_X where X is ADD, SUBTRACT, 
REVERSE_SUBTRACT, MIN, MAX 

colorWriteMask: VK_COLOR_COMPONENT_X where X is 
R_BIT, G_BIT, B_BIT, A _BIT 


void vkFreeMemory( 
VkDevice device, 
VkDeviceMemory memory, 
const VkAllocationCallbacks* pAllocator); EA 


Host Access to Device Memory Objects [10.2.1] 
Memory objects created with vkAllocateMemory are not 


directly host accessible. Memory objects created with memory 


property VK_MEMORY_PROPERTY_HOST_VISIBLE_BIT are 
considered mappable. Memory objects must be mappable in 
order to be successfully mapped on the host. 


VkResult vkMapMemory( 
VkDevice device, 
VkDeviceMemory memory, 
VkDeviceSize offset, 
VkDeviceSize size, 
VkMemoryMapFlags flags, E 
void** ppData); 


VkResult vkFlushMappedMemoryRanges( 
VkDevice device, 
uint32_t memoryRangeCount, 
const VkMappedMemoryRange* pMemoryRanges); 


VkResult vkInvalidateMappedMemoryRanges( 
VkDevice device, 
uint32_t memoryRangeCount, 
const VkMappedMemoryRange* pMemoryRanges); 


typedef struct VkMappedMemoryRange { 
VkStructureType sType; 
const void* pNext; 
VkDeviceMemory memory; 
VkDeviceSize offset; VkDeviceSize size; 
} VkMappedMemoryRange; 


typedef struct VkPipelineColorBlendAttachmentState { 
VkBool32 blendEnable; 
VkBlendFactor srcColorBlendFactor; 
VkBlendFactor dstColorBlendFactor; 
VkBlendOp colorBlendOp; EA 
VkBlendFactor srcAlphaBlendFactor; 
VkBlendFactor dstAlphaBlendFactor; 
VkBlendOp alphaBlendOp; EA 
VkColorComponentFlags colorWriteMask; 
} VkPipelineColorBlendAttachmentState; 


enum VkBlendFactor: VK_BLEND_FACTOR_X where X is 

ZERO, ONE, SRC_ALPHA_SATURATE, 
[ONE_MINUS_]SRC_COLOR, [ONE_MINUS_]DST_COLOR, 
[ONE_MINUS_]SRC_ALPHA, [ONE_MINUS_]DST_ALPHA, 
[ONE_MINUS_]CONSTANT_COLOR, 
[ONE_MINUS_]CONSTANT_ALPHA, 
[ONE_MINUS_]SRC1_COLOR, 
[ONE_MINUS_]SRC1_ALPHA 


colorWriteMask: 
VK_COLOR_COMPONENT_X_BIT where Xis R, G, B, A 


typedef struct VkPipelineDynamicStateCreatelnfo { 
VkStructureType sType; BA 
const void* pNext; 
VkPipelineDynamicStateCreateFlags flags; EX 
uint32_t dynamicStateCount; 
const VkDynamicState* pDynamicStates; 

} VkPipelineDynamicStateCreatelnfo; 


pDynamicStates: Array of VK_DYNAMIC_STATE_X 
where X is VIEWPORT, SCISSOR, 
LINE_WIDTH, DEPTH_BIAS, BLEND_CONSTANTS, 
DEPTH_BOUNDS, STENCIL_REFERENCE, 
STENCIL_COMPARE_MASK, STENCIL_WRITE_MASK 


Pipeline Destruction [9.3] 
void vkDestroyPipeline( 
VkDevice device, VkPipeline pipeline, 
const VkAllocationCallbacks* pAllocator); DEA 


Pipeline Cache [9.6] 

Pipeline cache objects allow the result of pipeline construction 
to be reused between pipelines and between runs of an 
application. 


VkResult vkCreatePipelineCache(VkDevice device, 
const VkPipelineCacheCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkPipelineCache* pPipelineCache); 


typedef struct VkPipelineCacheCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelineCacheCreateFlags flags; EX 
size_t initialDataSize; 
const void* pinitialData; 

} VkPipelineCacheCreatelnfo; 


VkResult vkMergePipelineCaches(VkDevice device, 
VkPipelineCache dstCache, uint32_t srcCacheCount, 
const VkPipelineCache* pSrcCaches); 


VkResult vkGetPipelineCacheData(VkDevice device, 
VkPipelineCache pipelineCache, 
size_t* pDataSize, void* pData); 


void vkDestroyPipelineCache(VkDevice device, 
VkPipelineCache pipelineCache, 
const VkAllocationCallbacks* pAllocator); BA 


Pipeline Binding [9.8] 

void vkCmdBindPipeline( 
VkCommandBuffer commandBuffer, 
VkPipelineBindPoint pipelineBindPoint, 
VkPipeline pipeline); 


void vkUnmapMemory( 
VkDevice device, 
VkDeviceMemory memory); 


Lazily Allocated Memory [10.2.2] 

If the memory object is allocated from a heap with the 
VK_MEMORY_PROPERTY_LAZILY_ALLOCATED_BIT bit set, 
that object’s backing memory may be provided by the 
implementation lazily. 


void vkGetDeviceMemoryCommitment( 
VkDevice device, 
VkDeviceMemory memory, 
VkDeviceSize* pCommittedMemorylnBytes); 


Peer Memory Features [10.2.4] 
void vkGetDeviceGroupPeerMemoryFeatures( 
VkDevice device, uint32_t heapindex, 
uint32_t localDevicelndex, uint32_t remoteDevicelndex, 
VkPeerMemoryFeatureFlags* pPeerMemoryFeatures); 
pPeerMemoryFeatures: VK_PEER_MEMORY_FEATURE_X 
where X is COPY_SRC_BIT, COPY_DST_BIT, 
GENERIC_SRC_BIT, GENERIC_DST_BIT 
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Vulkan Pipeline Diagram [9] 


Indirect Buffer 


Index Buffer 
Vertex Buffer 


Descriptor Sets 


Push Constants 


Uniform Buffer 


Uniform Texel Buffers 


Sampled Images 
Storage Buffers 
Storage Texel Buffers 


Storage Images 


Compt had 


Some Vulkan commands specify geometric objects 
to be drawn or computational work to be performed, 
while others specify state controlling how objects 
are handled by the various pipeline stages, or control 
data transfer between memory organized as images 
and buffers. Commands are effectively sent through 
a processing pipeline, either a graphics pipeline or a 
compute pipeline. 


E T Fixed Function Stage 
L I Shader Stage 


E1 Storage Images 


Color Attachments 


Allocate 


Command Buffer Lifecycle [5.1] 


A command buffer is always in one of the five states shown below: 


Initial state 

The state when a command buffer is first 
allocated. The command buffer may be reset 
back to this state from any of the executable, 
recording, or invalid states. Command buffers 
in the initial state can only be moved to 
recording, or freed. 


Executable command buffers can be 
submitted, reset, or recorded to another 
command buffer. 


Pending state 

Queue submission changes the state from 

executable to pending, in which applications 

must not attempt to modify the command 

buffer in any way. The state reverts back \ 

to executable when current executions Y 

complete, or to invalid. Completion with ~^, 
One Time Submit 


Recording state 
vkBeginCommandBuffer changes the 

state from initial to recording. Once in the 
recording state, vkCmd* commands can be 


used to record to the command buffer. Invalid state 


Some operations will transition the command 
buffer into the invalid state, in which it can 
only be reset or freed. 


Completion \ 


Executable 


Executable state 
vkEndCommandBuffer moves a command 


Submission 
buffer state from recording to executable. 


Buffer Views [11.2] 
A buffer view represents a contiguous range of a buffer and a 
specific format to be used to interpret the data. 


VkResult vkCreateBufferView( 
VkDevice device, 
const VkBufferViewCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, [= 
VkBufferView* pView); 


typedef struct VkBufferViewCreatelnfo { 
VkStructureType sType; 2A 
const void* pNext; 
VkBufferViewCreateFlags flags; EX 
VkBuffer buffer; 
VkFormat format; EE] 
VkDeviceSize offset; VkDeviceSize range; 
} VkBufferViewCreatelnfo; 


void vkDestroyBufferView( 
VkDevice device, 


typedef struct VkimageCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkimageCreateFlags flags; EE 
VkimageType imageType; EE 
VkFormat format; 
VkExtent3D extent; [XF] 
uint32_t mipLevels; uint32_t arrayLayers; 
VkSampleCountFlagBits samples; 
VkImageTiling tiling; EE] 
VkimageUsageFlags usage; 
VkSharingMode sharingMode; EX 
uint32_t queueFamilylndexCount; 
const uint32_t* pQueueFamilyindices; 
VklmageLayout initialLayout; 
}VkimageCreatelnfo; 
pNext must be NULL or point to: 
VkExternalMemorylmageCreatelnfo AE] 


Resource Creation [11] 


Buffers [11.1] 

Buffers represent linear arrays of data which are used for various 
purposes by binding them to a graphics or compute pipeline via 
descriptor sets or via certain commands, or by directly specifying 
them as parameters to certain commands. 


VkResult vkCreateBuffer( 
VkDevice device, 
const VkBufferCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkBuffer* pBuffer); 


typedef struct VkBufferCreatelnfo { 
VkStructureType sType; [TI 
const void* pNext; 
VkBufferCreateFlags flags; 
VkDeviceSize size; 
VkBufferUsageFlags usage; BA 


VkSharingMode sharingMode; typedef struct VkimageSwapchainCreatelnfoKHR { 


uint32_t queueFamilyIndexCount; 
const uint32_t* pQueueFamilyindices; 


VkBufferView bufferView, 
const VkAllocationCallbacks* pAllocator); [ZZ 


VkStructureType sType; 
const void* pNext; 


} VkBufferCreatelnfo; 
flags: 
VK_BUFFER_CREATE_SPARSE_X_BIT where X is ALIASED, 
BINDING, PROTECTED, RESIDENCY 
pNext must be NULL or point to: 
VkExternalMemoryBufferCreatelnfo 


void vkDestroyBuffer( 
VkDevice device, 
VkBuffer buffer, 
const VkAllocationCallbacks* pAllocator); 
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VkSwapchainKHR swapchain; 
Images [11.3] }VkimageSwapchainCreatelnfoKHR; 
Images represent multidimensional (up to 3) arrays of data which 
can be used for various purposes by binding them to the graphics VOid vkGetimageSubresourceLayout( 
or compute pipeline via descriptor sets, or by directly specifying VkDevice device, Vkimage image, 
them as parameters to certain commands. const VkimageSubresource* pSubresource, 
VkSubresourceLayout* pLayout); 
VkResult vkCreatelmage( 
VkDevice device, 
const VkimageCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, ŒA 
VkImage* pimage); 


typedef struct VkimageSubresource { 
VklmageAspectFlags aspectMask; EE 
uint32_t mipLevel; 
uint32_t arrayLayer; 

} VklmageSubresource; 
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Resource Creation (continued) 


typedef struct VkSubresourceLayout { 
VkDeviceSize offset; 
VkDeviceSize size; 
VkDeviceSize rowPitch; 
VkDeviceSize arrayPitch; 
VkDeviceSize depthPitch; 

} VkSubresourceLayout; 


void vkDestroylmage( 
VkDevice device, Vkimage image, 
const VkAllocationCallbacks* pAllocator); 


Image Views [11.5] 

Image objects are not directly accessed by pipeline shaders for 
reading or writing image data. Instead, image views representing 
contiguous ranges of the image subresources and containing 
additional metadata are used for that purpose. 


VkResult vkCreatelmageView( 
VkDevice device, 
const VklmageViewCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, [ZZ 
VkimageView* pView); 


typedef struct VkimageViewCreatelnfo { 
VkStructureType sType; EA 
const void* pNext; 
VkimageViewCreateFlags flags; EX 
Vkimage image; 
VklmageViewType viewType; 
VkFormat format; EXE] 
VkComponentMapping components; 
VklmageSubresourceRange subresourceRange; 
} VkImageViewCreatelnfo; 


viewType: VK_IMAGE_VIEW_TYPE_X where X is 1D, 2D, 3D, 
CUBE, 1D_ARRAY, 2D_ARRAY, CUBE_ARRAY 


pNext must be NULL or point to one of: 
VklmageViewUsageCreatelnfo 
VkSamplerYcbcrConversion|nfo 


Samplers [12] 

VkSampler objects encapsulate the state of an image sampler 
which is used by the implementation to read image data and 
apply filtering and other transformations for the shader. 


VkResult vkCreateSampler( 
VkDevice device, 
const VkSamplerCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, EA 
VkSampler* pSampler); 


typedef struct VkSamplerCreatelnfo { 
VkStructureType sType; EX 
const void* pNext; 
VkSamplerCreateFlags flags; El 
VkFilter magFilter; VkFilter minFilter; 
VkSamplerMipmapMode mipmapMode; 
VkSamplerAddressMode addressModeU; 
VkSamplerAddressMode addressModeV; 
VkSamplerAddressMode addressModeW; 
float mipLodBias; VkBool32 anisotropyEnable; 
float maxAnisotropy; VkBool32 compareEnable; 
VkCompareOp compareOp; 
float minLod; float maxLod; 
VkBorderColor borderColor; 
VkBool32 unnormalizedCoordinates; 
}VkSamplerCreatelnfo; 


Resource Descriptors [13] 
An opaque data structure representing a shader resource e.g., a 
buffer view, image view, sampler, or combined image sampler. 


Descriptor Set Layout [13.2.1] 

VkResult vkCreateDescriptorSetLayout( 
VkDevice device, 
const VkDescriptorSetLayoutCreatelnfo* pCreatelnfo 1 
const VkAllocationCallbacks* pAllocator, 
VkDescriptorSetLayout* pSetLayout); 


void vkGetDescriptorSetLayoutSupport( 
VkDevice device, 
const VkDescriptorSetLayoutCreatelnfo* pCreatelnfo, 
VkDescriptorSetLayoutSupport* pSupport); 


typedef struct VkDescriptorSetLayoutSupport { 
VkStructureType sType; BA 
void* pNext; VkBool32 supported; 

} VkDescriptorSetLayoutSupport; 
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typedef struct VkComponentMapping { 
VkComponentSwizzle r; 
VkComponentSwizzle g; 
VkComponentSwizzle b; 
VkComponentSwizzle a; 

} VkComponentMapping; 


enum VkComponentSwizzle: VK_COMPONENT_SWIZZLE_X 
where X is IDENTITY, ZERO, ONE, R, G, B, A 


void vkDestroyImageView(VkDevice device, 
VklmageView imageView, 
const VkAllocationCallbacks* pAllocator); 


Resource Memory Association [11.6] 

Resources are initially created as virtual allocations with no 
backing memory. Device memory is allocated separately and 
then associated with the resource. 


void vkGetBufferMemoryRequirements( 
VkDevice device, 
VkBuffer buffer, 
VkMemoryRequirements* pMemoryRequirements); [==] 


void vkGetBufferMemoryRequirements2(VkDevice device, 
const VkBufferMemoryRequirementsInfo2* pinfo, 
VkMemoryRequirements2* pMemoryRequirements); 


typedef struct VkBufferMemoryRequirementsinfo2 { 
VkStructureType sType; 
const void* pNext; 
VkBuffer buffer; 

} VkBufferMemoryRequirementsinfo2; 


void vkGetImageMemoryRequirements( 
VkDevice device, Vkimage image, 
VkMemoryRequirements* pMemoryRequirements); EE 


void vkGetImageMemoryRequirements2(VkDevice device, 
const VklmageMemoryRequirementsInfo2* pinfo, 
VkMemoryRequirements2* pMemoryRequirements); 


magfilter, minFilter: VK_FILTER_NEAREST, 
VK_FILTER_LINEAR 

mipmapMode: 
VK_SAMPLER_MIPMAP_MODE_{NEAREST, LINEAR} 

borderColor: VK_BORDER_COLOR_{FLOAT, INT}_X 
where X is TRANSPARENT_BLACK, OPAQUE_BLACK, 
OPAQUE_WHITE 


addressMode{U, V, W}: 
VK_SAMPLER_ADDRESS_MODE_X where X is REPEAT, 
MIRRORED_REPEAT, MIRROR_CLAMP_TO_EDGE, 
CLAMP_TO_EDGE, CLAMP_TO_BORDER 

pNext must be NULL or point to: 
VkSamplerYcbcrConversion|nfo 


void vkDestroySampler( 
VkDevice device, 
VkSampler sampler, 
const VkAllocationCallbacks* pAllocator); [XF] 


Sampler Y’CgCp Conversion [12.1] 


VkResult vkCreateSamplerYcbcrConversion( 
VkDevice device, 
const VkSamplerYcbcrConversionCreatelnfo* 
pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkSamplerYcbcrConversion* pYchcrConversion); 


void vkDestroyDescriptorSetLayout( 
VkDevice device, 
VkDescriptorSetLayout descriptorSetLayout,, 
const VkAllocationCallbacks* pAllocator); 


Pipeline Layouts [13.2.2] 

VkResult vkCreatePipelineLayout( 
VkDevice device, 
const VkPipelineLayoutCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, EA 
VkPipelineLayout* pPipelineLayout); 


typedef struct VkPipelineLayoutCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelineLayoutCreateFlags flags; El 
uint32_t setLayoutCount; 
const VkDescriptorSetLayout* pSetLayouts; 
uint32_t pushConstantRangeCount; 
const VkPushConstantRange* pPushConstantRanges; 
} VkPipelineLayoutCreatelnfo; 


typedef struct VkimageMemoryRequirementsinfo2 { 
VkStructureType sType; [==] 
const void* pNext; 
Vkimage image; 
}VkimageMemoryRequirementsinfo2; 
pNext must be NULL or point to: 
VkimagePlaneMemoryRequirementsinfo 


VkResult vkBindBufferMemory(VkDevice device, 
VkBuffer buffer, VkDeviceMemory memory, 
VkDeviceSize memoryOffset); 


VkResult vkBindBufferMemory2(VkDevice device, 
uint32_t bindinfoCount, 
const VkBindBufferMemorylnfo* pBindinfos); 


typedef struct VkBindBufferMemoryinfo { 
VkStructureType sType; [=] 
const void* pNext; 
VkBuffer buffer; 
VkDeviceMemory memory; 
VkDeviceSize memoryOffset; 
} VkBindBufferMemoryInfo; 
pNext must be NULL or point to: 
VkBindBufferMemoryDeviceGrouplnfo 


VkResult vkBindimageMemory(VkDevice device, 
Vkimage image, VkDeviceMemory memory, 
VkDeviceSize memoryOffset); 


VkResult vkBindlmageMemory2(VkDevice device, 
uint32_t bindinfoCount, 
const VkBindimageMemoryinfo* pBindinfos); 


typedef struct VkBindimageMemoryinfo { 
VkStructureType sType; [XH 
const void* pNext; 
Vkimage image; 
VkDeviceMemory memory; 
VkDeviceSize memoryOffset; 
} VkBindlmageMemoryInfo; 
pNext must be NULL or point to one of: 
VkBindimageMemoryDeviceGroupinfo 
VkBindimagePlaneMemoryinfo 


typedef struct VkSamplerYchcrConversionCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkFormat format; [EI 
VkSamplerYcbcrModelConversion ycbcrModel; 
VkSamplerYcbcrRange ycbcrRange; 
VkComponentMapping components; 
VkChromaLocation xChromaOffset; 
VkChromaLocation yChromaOffset; 
VkFilter chromafilter; 
VkBool32 forceExplicitReconstruction; 

} VkSamplerYcbcrConversionCreatelnfo; 


VkSamplerYcbcrModelConversion: 
VK_SAMPLER_YCBCR_MODEL_CONVERSION_X where X 
is {RGB, YCBCR}_IDENTITY, YCBCR_{709, 601, 2020} 


VkSamplerYcbcrRange: 
VK_SAMPLER_YCBCR_RANGE_ITU_{FULL, NARROW} 


VkChromaLocation: 
VK_CHROMA_LOCATION_{COSITED_EVEN, MIDPOINT} 


VkFilter: 
VK_FILTER_{NEAREST, LINEAR} 


void vkDestroySamplerYcbcrConversion(VkDevice device, 
VkSamplerYchcrConversion ycbcrConversion, 
const VkAllocationCallbacks* pAllocator); 


typedef struct VkPushConstantRange { 
VkShaderStageFlags stageFlags; 
uint32_t offset; uint32_t size; 

} VkPushConstantRange; 


void vkDestroyPipelineLayout( 
VkDevice device, VkPipelineLayout pipelineLayout, 
const VkAllocationCallbacks* pAllocator); 


Allocation of Descriptor Sets [13.2.3] 
VkResult vkCreateDescriptorPool( 
VkDevice device, 
const VkDescriptorPoolCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, EA 
VkDescriptorPool* pDescriptorPool); 


typedef struct VkDescriptorPoolCreatelnfo { 
VkStructureType sType; EF 
const void* pNext; VkDescriptorPoolCreateFlags flags; 
uint32_t maxSets; uint32_t poolSizeCount; 
const VkDescriptorPoolSize* pPoolSizes; 
}VkDescriptorPoolCreatelnfo; 
Continued on next page > 
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Resource Descriptors (continued) 


flags: 


VK_DESCRIPTOR_POOL_CREATE_FREE_DESCRIPTOR_SET_BIT 


typedef struct VkDescriptorPoolSize { 
VkDescriptorType type; 
uint32_t descriptorCount; 

} VkDescriptorPoolSize; 


void vkDestroyDescriptorPool( 
VkDevice device, 
VkDescriptorPool descriptorPool, 
const VkAllocationCallbacks* pAllocator); EA 


VkResult vkAllocateDescriptorSets( 
VkDevice device, 
const VkDescriptorSetAllocatelnfo* pAllocatelnfo, 
VkDescriptorSet* pDescriptorSets); 


typedef struct VkDescriptorSetAllocatelnfo { 
VkStructureType sType; 
const void* pNext; VkDescriptorPool descriptorPool; 
uint32_t descriptorSetCount; 
const VkDescriptorSetLayout* pSetLayouts; 
}VkDescriptorSetAllocatelnfo; 


VkResult vkFreeDescriptorSets| 
VkDevice device, 
VkDescriptorPool descriptorPool, 
uint32_t descriptorSetCount, 
const VkDescriptorSet* pDescriptorSets); 


VkResult vkResetDescriptorPool( 
VkDevice device, 
VkDescriptorPool descriptorPool, 
VkDescriptorPoolResetFlags flags); 


Descriptor Set Updates [13.2.4] 
void vkUpdateDescriptorSets| 
VkDevice device, 
uint32_t descriptorWriteCount, 
const VkWriteDescriptorSet* pDescriptorWrites, 
uint32_t descriptorCopyCount, 
const VkCopyDescriptorSet* pDescriptorCopies); 


typedef struct VkWriteDescriptorSet { 
VkStructureType sType; [==] 
const void* pNext; VkDescriptorSet dstSet; 
uint32_t dstBinding; 
uint32_t dstArrayElement; 
uint32_t descriptorCount; 
VkDescriptorType descriptorType; 
const VkDescriptorlmagelnfo* pImagelnfo; 
const VkDescriptorBufferinfo* pBufferinfo; 
const VkBufferView* pTexelBufferView:; 

} VkWriteDescriptorSet; 


Queries [16] 


Query Pools [16.1] 


VkResult vkCreateQueryPool( 
VkDevice device, 
const VkQueryPoolCreatelnfo* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, [XF] 
VkQueryPool* pQueryPool); 


typedef struct VkQueryPoolCreatelnfo { 
VkStructureType sType; EX 
const void* pNext; 
VkQueryPoolCreateFlags flags; El 
VkQueryType queryType; 
uint32_t queryCount; 
VkQueryPipelineStatisticFlags pipelineStatistics; 
}VkQueryPoolCreatelnfo; 
queryType: VK_QUERY_TYPE_OCCLUSION, 
VK_QUERY_TYPE_PIPELINE_STATISTICS, 
VK_QUERY_TYPE_TIMESTAMP 


void vkDestroyQueryPool( 
VkDevice device, 
VkQueryPool queryPool, 
const VkAllocationCallbacks* pAllocator); EA 


Query Operation [16.2] 

void vkCmdResetQueryPool( 
VkCommandBuffer commandBuffer, 
VkQueryPool queryPool, 
uint32_t firstQuery, 
uint32_t queryCount); 


void vkCmdBeginQuery( 
VkCommandBuffer commandBuffer, 
VkQueryPool queryPool, 
uint32_t entry, 
VkQueryControlFlags flags); 
flags: VK_QUERY_CONTROL_PRECISE_BIT 
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typedef struct VkDescriptorlmagelnfo { 
VkSampler sampler; 
VkimageView imageView; 
VkimageLayout imageLayout; [FE] 
}VkDescriptorlmagelnfo; 


typedef struct VkDescriptorBufferlnfo { 
VkBuffer buffer; 
VkDeviceSize offset; VkDeviceSize range; 
} VkDescriptorBufferinfo; 


typedef struct VkCopyDescriptorSet { 
VkStructureType sType; 
const void* pNext; VkDescriptorSet srcSet; 
uint32_t srcBinding; 
uint32_t srcArrayElement; 
VkDescriptorSet dstSet; 
uint32_t dstBinding; 
uint32_t dstArrayElement; 
uint32_t descriptorCount; 

} VkCopyDescriptorSet; 


Descriptor Set Updates with Templates [13.2.6] 
VkResult vkCreateDescriptorUpdateTemplate( 
VkDevice device, 
const VkDescriptorUpdateTemplateCreatelnfo* 
pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, [ZY 
VkDescriptorUpdateTemplate* 
pDescriptorUpdateTemplate); 


typedef struct VkDescriptorUpdateTemplateCreatelnfo { 
VkStructureType sType; 
void* pNext; 
VkDescriptorUpdateTemplateCreateFlags flags; EX 
uint32_t descriptorUpdateEntryCount; 
const VkDescriptorUpdateTemplateEntry* 
pDescriptorUpdateEntries; 
VkDescriptorUpdateTemplateType template Type; 
VkDescriptorSetLayout descriptorSetLayout; 
VkPipelineBindPoint pipelineBindPoint; EES) 
VkPipelineLayout pipelineLayout; 
uint32_t set; El 
} VkDescriptorUpdateTemplateCreatelnfo; 
VKPipelineBindPoint: VK_PIPELINE_BIND_POINT_X 
where X is GRAPHICS, COMPUTE 


templateType: VK_DESCRIPTOR_UPDATE_TEMPLATE_- 
TYPE_DESCRIPTOR_SET 


typedef struct VkDescriptorUpdateTemplateEntry { 
uint32_t dstBinding; 
uint32_t dstArrayElement; 
uint32_t descriptorCount; 
VkDescriptorType descriptorType; 
size_t offset; size_t stride; 
} VkDescriptorUpdateTemplateEntry; 


void vkCmdEndQuery( 


VkCommandBuffer commandBuffer, 
VkQueryPool queryPool, 
uint32_t query); 


VkResult vkGetQueryPoolResults( 


VkDevice device, 
VkQueryPool queryPool, 
uint32_t firstQuery, 
uint32_t queryCount, 
size_t dataSize, 
void* pData, 
VkDeviceSize stride, 
VkQueryResultFlags flags); 
flags: VK_QUERY_RESULT_X_BIT where X is 
64, WAIT, WITH_AVAILABILITY, PARTIAL 


void vkCmdCopyQueryPoolResults( 


VkCommandBuffer commandBuffer, 
VkQueryPool queryPool, 
uint32_t firstQuery, 
uint32_t queryCount, 
VkBuffer dstBuffer, 
VkDeviceSize dstOffset, 
VkDeviceSize stride, 
VkQueryResultFlags flags); 
flags: VK_QUERY_RESULT_X_BIT where X is 
64, WAIT, WITH_AVAILABILITY, PARTIAL 


Timestamp Queries [16.5] 
void vkCmdWriteTimestamp( 


VkCommandBuffer commandBuffer, 
VkPipelineStageFlagBits pipelineStage, [XE] 
VkQueryPool queryPool, 

uint32_t query); 


void vkDestroyDescriptorUpdateTemplate( 
VkDevice device, 
VkDescriptorUpdateTemplate 
descriptorUpdate Template, 
const VkAllocationCallbacks* pAllocator); 


void vkUpdateDescriptorSetWithTemplate( 
VkDevice device, 
VkDescriptorSet descriptorSet, 
VkDescriptorUpdateTemplate 
descriptorUpdate Template, 
const void* pData); 


Descriptor Set Binding [13.2.7] 

void vkCmdBindDescriptorSets| 
VkCommandBuffer commandBuffer, 
VkPipelineBindPoint pipelineBindPoint, [EX 
VkPipelineLayout layout, [XI 
uint32_t firstSet, 
uint32_t descriptorSetCount, 
const VkDescriptorSet* pDescriptorSets, 
uint32_t dynamicOffsetCount, 
const uint32_t* pDynamicOffsets); 


Push Constant Updates [13.2.8] 

The pipeline layout defines shader push constants which 
are updated via Vulkan commands rather than via writes to 
memory or copy commands. 


void vkCmdPushConstants( 
VkCommandBuffer commandBuffer, 
VkPipelineLayout layout, EX 
VkShaderStageFlags stageFlags, 
uint32_t offset, uint32_t size, 
const void* pValues); 


Clear Commands [17] 


Outside a Render Pass Instance [17.1] 
void vkCmdClearColorlmage( 
VkCommandBuffer commandBuffer, 
Vkimage image, 
VkimageLayout imageLayout, 
const VkClearColorValue* pColor, 
uint32_t rangeCount, 
const VklmageSubresourceRange* pRanges); 
imageLayout: 
VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL, 
VK_IMAGE_LAYOUT_GENERAL. 
VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR 


void vkCmdClearDepthStencillmage( 

VkCommandBuffer commanaBuffer, 

Vkimage image, 

VkimageLayout imageLayout, 

const VkClearDepthStencilValue* pDepthStencil, EA 

uint32_t rangeCount, 

const VklmageSubresourceRange* pRanges); 

imageLayout: 

VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL, 
VK_IMAGE_LAYOUT_GENERAL 


Inside a Render Pass Instance [17.2] 
void vkCmdClearAttachments( 
VkCommandBuffer commandBuffer, 
uint32_t attachmentCount, 
const VkClearAttachment* pAttachments, 
uint32_t rectCount, 
const VkClearRect* pRects); 


typedef struct VkClearRect { 
VkRect2D rect; 
uint32_t baseArrayLayer; 
uint32_t layerCount; 

} VkClearRect; 


typedef struct VkClearAttachment { 
VkimageAspectFlags aspectMask; 
uint32_t colorAttachment; 
VkClearValue clearValue; 

}VkClearAttachment; 


Filling Buffers [17.4] 

void vkCmdFillBuffer( 
VkCommandBuffer commandBuffer, 
VkBuffer dstBuffer, VkDeviceSize dstOffset, 
VkDeviceSize size, uint32_t data); 


Updating Buffers [17.5] 

void vkCmdUpdateBuffer( 
VkCommandBuffer commandBuffer, 
VkBuffer dstBuffer, VkDeviceSize dstOffset, 
VkDeviceSize dataSize, const void* pData); 
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Drawing Commands [19] 


void vkCmdBindindexBuffer| 
VkCommandBuffer commandBuffer, 
VkBuffer buffer, VkDeviceSize offset, 
VkIndexType indexType); 
indexType: VK_INDEX_TYPE_UINT{16, 32} 


void vkCmdDraw( 
VkCommandBuffer commandBuffer, 
uint32_t vertexCount, uint32_t instanceCount, 
uint32_t firstVertex, uint32_t firstinstance); 


void vkCmdDrawIindexed( 
VkCommandBuffer commandBuffer, 
uint32_t indexCount, uint32_t instanceCount, 
uint32_t firstindex, int32_t vertexOffset, 
uint32_t firstinstance); 


void vkCmdDrawiIndirect( 
VkCommandBuffer commandBuffer, 
VkBuffer buffer, VkDeviceSize offset, 
uint32_t drawCount, 
uint32_t stride); 


typedef struct VkDrawIndirectCommand { 
uint32_t vertexCount; uint32_t instanceCount; 
uint32_t firstVertex; uint32_t firstinstance; 

} VkDrawIndirectCommand; 


void vkCmdDrawindexedindirect( 
VkCommandBuffer commandBuffer, 
VkBuffer buffer, VkDeviceSize offset, 
uint32_t drawCount, uint32_t stride); 


typedef struct VkDrawlndexedindirectCommand { 
uint32_t indexCount; uint32_t instanceCount; 
uint32_t firstindex; int32_t vertexOffset; 
uint32_t firstinstance; 

} VkDrawIndexedindirectCommand; 


Fixed-Function Vertex Postprocessing [23] 


Controlling the Viewport [23.5] 
void vkCmdSetViewport( 
VkCommandBuffer commanaBuffer, 
uint32_t firstViewport, 
uint32_t viewportCount, 
const VkViewport* pViewports); B8 


Rasterization [24] 


Basic Line Segment Rasterization [24.6] 
void vkCmdSetLineWidth( 
VkCommandBuffer commandBuffer, 
float lineWidth); 


Depth Bias [24.7.3] 

void vkCmdSetDepthBias( 
VkCommandBuffer commandBuffer, 
float depthBiasConstantFactor, 
float depthBiasClamp, 
float depthBiasSlopeFactor); 


Framebuffer: Blend Factors [26.1.1] 


void vkCmdSetBlendConstants( 
VkCommandBuffer commanaBuffer, 
const float blendConstants[4]); 


Sparse Resources [28] 


Sparse Image Format Properties [28.7.3] 

void vkGetPhysicalDeviceSparselmageFormatProperties( 
VkPhysicalDevice physicalDevice, VkFormat format, 
VklmageType type, LXE] 
VkSampleCountFlagBits samples, EA 
VkimageUsageFlags usage, 
VklmageTiling tiling, ZE 
uint32_t* pPropertyCount, 
VkSparselmageFormatProperties* pProperties); 


typedef struct VkSparselmageFormatProperties { 
VkimageAspectFlags aspectMask; [EE] 
VkExtent3D imageGranularity; EA 
VkSparselmageFormatFlags flags; 


Copy Commands [18] 


Copying Data Between Buffers [18.2] 
void vkCmdCopyBuffer( 
VkCommandBuffer commandBuffer, 
VkBuffer srcBuffer, VkBuffer dstBuffer, 
uint32_t regionCount, 
const VkBufferCopy* pRegions); 


typedef struct VkBufferCopy { 
VkDeviceSize srcOffset; VkDeviceSize dstOffset; 
VkDeviceSize size; 

} VkBufferCopy; 


Copying Data Between Images [18.3] 
void vkCmdCopylmage( 
VkCommandBuffer commandBuffer, 
Vklmage srcimage, 
VkImageLayout srclmageLayout, [XE] 
Vklmage dstimage, 
VkimageLayout dstimageLayout, 
uint32_t regionCount, 
const VklmageCopy* pRegions); 


typedef struct VkimageCopy { 
VkImageSubresourceLayers srcSubresource; 
VkOffset3D srcOffset; [TI 
VkimageSubresourceLayers dstSubresource; SE 
VkOffset3D dstOffset; [AE] 
VkExtent3D extent; BA 

} VkImageCopy; 


Copying Data Between Buffers and Images [18.4] 
void vkCmdCopyBufferTolmage( 
VkCommandBuffer commanaBuffer, 
VkBuffer srcBuffer, Vkimage dstimage, 
VkImageLayout dstimageLayout, 
uint32_t regionCount, 
const VkBufferlmageCopy* pRegions); 


Vertex Input Description [20.2] 


void vkCmdBindVertexBuffers( 
VkCommandBuffer commandBuffer, 
uint32_t firstBinding, uint32_t bindingCount, 
const VkBuffer* pBuffers, 
const VkDeviceSize* pOffsets); 


Fragment Operations [25] 


Scissor Test [25.2] 

void vkCmdSetScissor( 
VkCommandBuffer commandBuffer, 
uint32_t firstScissor, uint32_t scissorCount, 
const VkRect2D* pScissors); [XE] 


Depth Bounds Test [25.8] 
void vkCmdSetDepthBounds( 
VkCommandBuffer commandBuffer, 
float minDepthBounds, float maxDepthBounds); 


Stencil Test [25.9] 

void vkCmdSetStencilCompareMask( 
VkCommandBuffer commandBuffer, 
VkStencilFaceFlags faceMask, uint32_t compareMask); 


void vkCmdSetStencilWriteMask( 
VkCommandBuffer commandBuffer, 
VkStencilFaceFlags faceMask, 
uint32_t writeMask); 


void vkCmdSetStencilReference( 
VkCommandBuffer commandBuffer, 
VkStencilFaceFlags faceMask, 
uint32_t reference); 


faceMask: VK_STENCIL_FACE_{FRONT, BACK} BIT, 
VK_STENCIL_FRONT_AND_BACK 


flags: VK_SPARSE_IMAGE_FORMAT_X where X is 
SINGLE_MIPTAIL_BIT, ALIGNED_MIP_SIZE_BIT, 
NONSTANDARD_BLOCK_SIZE_BIT 


void vkGetPhysicalDeviceSparselmageFormatProperties2( 
VkPhysicalDevice physicalDevice, 
const VkPhysicalDeviceSparselmageFormatinfo2* 
pFormatinfo, 
uint32_t* pPropertyCount, 
VkSparselmageFormatProperties2* pProperties); 


typedef struct VkSparselmageFormatProperties2 { 
VkStructureType sType; EX 
void* pNext; 
VkSparselmageFormatProperties properties; 

} VkSparselmageFormatProperties2; 


void vkCmdCopylmageToBuffer( 
VkCommandBuffer commandBuffer, 
VkImage srcimage, 
VkimageLayout srcImageLayout, 
VkBuffer dstBuffer, 
uint32_t regionCount, 
const VkBufferlmageCopy* pRegions); 


typedef struct VkBufferlmageCopy { 
VkDeviceSize bufferOffset; 
uint32_t bufferRowLength; 
uint32_t bufferlmageHeight; 
VkImageSubresourceLayers imageSubresource; 
VkOffset3D imageOffset; 
VkExtent3D imageExtent; 

} VkBufferlmageCopy; 


Image Copies With Scaling [18.5] 
void vkCmdBlitimage( 
VkCommandBuffer commandBuffer, 
VkImage srclmage, 
VkimageLayout srcimageLayout, 
VkImage dstimage, 
VkImageLayout dstimageLayout, [EE] 
uint32_t regionCount, 
const VkimageBlit* pRegions, 
VkFilter filter); 
filter: VK_FILTER_NEAREST, VK_FILTER_LINEAR 


typedef struct VklmageBlit { 
VkImageSubresourceLayers srcSubresource; [XE] 
VkOffset3D srcOffsets[2]; 
VklmageSubresourceLayers dstSubresource; 
VkOffset3D dstOffsets[2]; 
} VkimageBlit; 


Resolving Multisample Images [18.6] 
void vkCmdResolvelmage( 
VkCommandBuffer commandBuffer, 
Vkimage srclmage, 
VkimageLayout srclmageLayout, 
Vkimage dstimage, 
VkimageLayout dstimageLayout, 
uint32_t regionCount, 
const VkimageResolve* pRegions); 


typedef struct VkimageResolve { 
VklmageSubresourceLayers srcSubresource; EE 
VkOffset3D srcOffset; 
VklmageSubresourceLayers dstSubresource; 
VkOffset3D dstOffset; A 
VkExtent3D extent; 

} VklmageResolve; 


Dispatching Commands [27] 


void vkCmdDispatch( 
VkCommandBuffer commandBuffer, 
uint32_t groupCountx, 
uint32_t groupCountY, 
uint32_t groupCountz); 


void vkCmdDispatchIndirect( 
VkCommandBuffer commandBuffer, 
VkBuffer buffer, 
VkDeviceSize offset); 


typedef struct VkDispatchindirectCommand { 
uint32_t x; 
uint32_t y; 
uint32_t z; 

} VkDispatchIndirectCcommand; 


void vkCmdDispatchBase( 
VkCommandBuffer commandBuffer, 
uint32_t baseGroupX, uint32_t baseGroupY, 
uint32_t baseGroupZ, uint32_t groupCountx, 
uint32_t groupCountY, uint32_t groupCountZ); 


typedef struct VkPhysicalDeviceSparselmageFormatinfo2 { 
VkStructureType sType; [TI 
const void* pNext; 
VkFormat format, 
VkimageType type, 
VkSampleCountFlagBits samples, 
VkimageUsageFlags usage, 
VkImageTiling tiling, [==] 
} VkPhysicalDeviceSparselmageFormatInfo2; 


Sparse Resource Memory Requirements [28.7.5] 
void vkGetimageSparseMemoryRequirements( 
VkDevice device, VkImage image, 
uint32_t* pSparseMemoryRequirementCount, 
VkSparselmageMemoryRequirements* 
pSparseMemoryRequirements); 


} VkSparselmageFormatProperties; Continued on next page > 
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Sparse Resources (continued) 


typedef struct VkSparselmageMemoryRequirements { 
VkSparselmageFormatProperties formatProperties; 
uint32_t imageMipTailFirstLod; 
VkDeviceSize imageMipTailSize; 
VkDeviceSize imageMipTailOffset; 
VkDeviceSize imageMipTailStride; 

} VkSparselmageMemoryRequirements; 


void vkGetImageSparseMemoryRequirements2( 
VkDevice device, 
const VkimageSparseMemoryRequirementsinfo2* pinfo, 
uint32_t* pSparseMemoryRequirementCount, 
VkSparselmageMemoryRequirements2* 
pSparseMemoryRequirements); 


typedef struct VkImageSparseMemoryRequirementsInfo2 { 
VkStructureType sType; ZH 
const void* pNext; 
Vklmage image; 

} VklmageSparseMemoryRequirementsInfo2; 


typedef struct VkSparselmageMemoryRequirements2 { 
VkStructureType sType; LA 
void* pNext; 
VkSparselmageMemoryRequirements 
memoryRequirements; 
} VkSparselmageMemoryRequirements2; 


Window System Integration (WSI) [29] 


Android Platform [29.2.1] 

VkResult vkCreateAndroidSurfaceKHR( 
Vkinstance instance, 
const VkAndroidSurfaceCreatelnfoKHR* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkSurfaceKHR* pSurface); 


typedef struct VkAndroidSurfaceCreatelnfoKHR { 
VkStructureType sType; 
const void* pNext; 
VkAndroidSurfaceCreateFlagsKHR flags; EI 
struct ANativeWindow* window; 

} VkAndroidSurfaceCreatelnfoKHR; 


Wayland Platform [29.2.3] 

VkResult vkCreateWaylandSurfaceKHR( 
Vkinstance instance, 
const VkWaylandSurfaceCreatelnfoKHR* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkSurfaceKHR* pSurface); 


typedef struct VkWaylandSurfaceCreatelnfoKHR { 
VkStructureType sType; 
const void* pNext; 
VkWaylandSurfaceCreateFlagsKHR flags; EI 
struct wl_display* display; 
struct wl_surface* surface; 
}VkWaylandSurfaceCreatelnfoKHR; 


Win32 Platform [29.2.4] 

VkResult vkCreateWin32SurfaceKHR( 
Vkinstance instance, 
const VkWin32SurfaceCreatelnfoKHR* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkSurfaceKHR* pSurface); 


typedef struct VkWin32SurfaceCreatelnfoKHR { 
VkStructureType sType; EX 
const void* pNext; 
VkWin32SurfaceCreateFlagsKHR flags; BE 
HINSTANCE hinstance; HWND hwnd; 

} VkWin32SurfaceCreatelnfoKHR; 


XCB Platform [29.2.5] 

VkResult vkCreateXcbSurfaceKHR( 
Vkinstance instance, 
const VkXcbSurfaceCreatelnfoKHR* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkSurfaceKHR* pSurface); 


typedef struct VkXcbSurfaceCreatelInfoKHR { 
VkStructureType sType; 
const void* pNext; 
VkXcbSurfaceCreateFlagsKHR flags; E 
xcb_connection_t* connection; xcb_window_t window; 
} VkXchSurfaceCreatelnfoKHR; 


Xlib Platform [29.2.6] 

VkResult vkCreateXlibSurfaceKHR( 
Vkinstance instance, 
const VkXIibSurfaceCreatelnfoKHR* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkSurfaceKHR* pSurface); 


©2018 Khronos Group - Rev. 1118 


Binding Resource Memory [28.7.6] 
typedef struct VkBindSparselnfo { 
VkStructureType sType; BA 
const void* pNext; 
uint32_t waitSemaphoreCount; 
const VkSemaphore* pWaitSemaphores; 
uint32_t bufferBindCount; 
const VkSparseBufferMemoryBindInfo* pBufferBinds; 
uint32_t imageOpaqueBindCount; 
const VkSparselmageOpaqueMemoryBindInfo* 
plmageOpaqueBinds; 
uint32_t imageBindCount; 
const VkSparselmageMemoryBindInfo* plmageBinds; 
uint32_t signalSemaphoreCount; 
const VkSemaphore* pSignalSemaphores; 
} VkBindSparselnfo; 
pNext must be NULL or point to: 
VkDeviceGroupBindSparselnfo AA 


typedef struct VkSparseBufferMemoryBindinfo { 
VkBuffer buffer; 
uint32_t bindCount; 
const VkSparseMemoryBind* pBinds; 

} VkSparseBufferMemoryBindInfo; 


typedef struct VkXlibSurfaceCreatelnfoKHR { 
VkStructureType sType; BA 
const void* pNext; 
VkXlibSurfaceCreateFlagsKHR flags; EX 
Display* dpy; Window window; 
}VkXlibSurfaceCreatelnfoKHR; 


Platform-Independent Information [29.2.7] 
void vkDestroySurfaceKHR( 
VkInstance instance, VkSurfaceKHR surface, 
const VkAllocationCallbacks* pAllocator); EA 


Display Enumeration [29.3.1] 

VkResult vkGetPhysicalDeviceDisplayPropertiesKHR( 
VkPhysicalDevice physicalDevice, 
uint32_t* pPropertyCount, 
VkDisplayPropertiesKHR* pProperties); 


typedef struct VkDisplayPropertiesKHR { 
VkDisplayKHR display; const char* displayName; 
VkExtent2D physicalDimensions; EH 
VkExtent2D physicalResolution; EF] 
VkSurfaceTransformFlagsKHR supportedTransforms; 
VkBool32 planeReorderPossible; 
VkBool32 persistentContent; 

} VkDisplayPropertiesKHR; 


VkResult vkGetPhysicalDeviceDisplayProperties2KHR ( 
VkPhysicalDevice physicalDevice, 
uint32_t* pPropertyCount, 
VkDisplayProperties2KHR* pProperties); 


typedef struct VkDisplayProperties2KHR { 
VkStructureType sType; ZA 
void* pNext; 
VkDisplayPropertiesKHR displayProperties; 
} VkDisplayProperties2KHR; 


Display Planes 

VkResult vkGetPhysicalDeviceDisplayPlanePropertiesKHR( 
VkPhysicalDevice physicalDevice, 
uint32_t* pPropertyCount, 
VkDisplayPlanePropertiesKHR* pProperties); 


typedef struct VkDisplayPlanePropertiesKHR { 
VkDisplayKHR currentDisplay; uint32_t currentStackIndex; 
} VkDisplayPlanePropertiesKHR; 


VkResult vkGetPhysicalDeviceDisplayPlaneProperties2KHR ( 
VkPhysicalDevice physicalDevice, 
uint32_t* pPropertyCount, 
VkDisplayPlaneProperties2KHR* pProperties); 


typedef struct VkDisplayPlaneProperties2KHR { 
VkStructureType sType; BA 
void* pNext; 
VkDisplayPlanePropertiesKHR displayPlaneProperties; 
} VkDisplayPlaneProperties2KHR; 


VkResult vkGetDisplayPlaneSupportedDisplaysKHR( 
VkPhysicalDevice physicalDevice, uint32_t planelndex, 
uint32_t* pDisplayCount, VkDisplayKHR* pDisplays); 


Display Modes 

VkResult vkGetDisplayModePropertiesKHR( 
VkPhysicalDevice physicalDevice, VkDisplayKHR display, 
uint32_t* pPropertyCount, 
VkDisplayModePropertiesKHR* pProperties); 


typedef struct VkSparselmageOpaqueMemoryBindinfo { 
Vkimage image; 
uint32_t bindCount; 
const VkSparseMemoryBind* pBinds; EA 

} VkSparselmageOpaqueMemoryBindInfo; 


typedef struct VkSparselmageMemoryBindinfo { 
Vkimage image; 
uint32_t bindCount; 
const VkSparselmageMemoryBind* pBinds; 

} VkSparselmageMemoryBindinfo; 


typedef struct VkSparselmageMemoryBind { 
VkimageSubresource subresource; 
VkOffset3D offset; BU 
VkExtent3D extent; 
VkDeviceMemory memory; 
VkDeviceSize memoryOffset; 
VkSparseMemoryBindFlags flags; 

} VkSparselmageMemoryBind; 


flags: VK_SPARSE_MEMORY_BIND_METADATA_BIT 


VkResult vkQueueBindSparse( 
VkQueue queue, 
uint32_t bindinfoCount, 
const VkBindSparselnfo* pBindinfo, 
VkFence fence); 


typedef struct VkDisplayModePropertiesKHR { 
VkDisplayModeKHR displayMode; 
VkDisplayModeParametersKHR parameters; 
} VkDisplayModePropertiesKHR; 


typedef struct VkDisplayModeParametersKHR { 
VkExtent2D visibleRegion; 
uint32_t refreshRate; 

} VkDisplayModeParametersKHR; 


VkResult vkGetDisplayModeProperties2KHR ( 
VkPhysicalDevice physicalDevice, 
VkDisplayKHR display, uint32_t* pPropertyCount, 
VkDisplayModeProperties2KHR* pProperties); 


typedef struct VkDisplayModeProperties2KHR { 
VkStructureType sType; 
void* pNext; 
VkDisplayModePropertiesKHR displayModeProperties; 
} VkDisplayModeProperties2KHR; 


VkResult vkCreateDisplayModeKHR( 
VkPhysicalDevice physicalDevice, VkDisplayKHR display, 
const VkDisplayModeCreatelnfoKHR* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkDisplayModeKHR* pMode); 


typedef struct VkDisplayModeCreatelnfoKHR { 
VkStructureType sType; 
const void* pNext; 
VkDisplayModeCreateFlagsKHR flags; E 
VkDisplayModeParametersKHR parameters; 
} VkDisplayModeCreatelnfoKHR; 


VkResult vkGetDisplayPlaneCapabilitiesKHR( 
VkPhysicalDevice physicalDevice, 
VkDisplayModeKHR mode, uint32_t planelndex, 
VkDisplayPlaneCapabilitiesKHR* pCapabilities); 


typedef struct VkDisplayPlaneCapabilitiesKHR { 
VkDisplayPlaneAlphaFlagsKHR supportedAlpha; 
VkOffset2D minSrcPosition; LE 
VkOffset2D maxSrcPosition; 
VkExtent2D minSrcExtent; BA 
VkExtent2D maxSrcExtent; BA 
VkOffset2D minDstPosition; 
VkOffset2D maxDstPosition; BA 
VkExtent2D minDstExtent; 
VkExtent2D maxDstExtent; 

} VkDisplayPlaneCapabilitiesKHR; 


VkResult vkGetDisplayPlaneCapabilities2KHR ( 
VkPhysicalDevice physicalDevice, 
const VkDisplayPlanelnfo2KHR* pDisplayPlanelnfo, 
VkDisplayPlaneCapabilities2KHR* pCapabilities); 


typedef struct VkDisplayPlanelnfo2KHR { 
VkStructureType sType; ZA 
const void* pNext; 
VkDisplayModeKHR mode; uint32_t planeindex; 
}VkDisplayPlanelnfo2KHR; 


typedef struct VkDisplayPlaneCapabilities2KHR { 
VkStructureType sType; 
void* pNext; 
VkDisplayPlaneCapabilitiesKHR capabilities; 

} VkDisplayPlaneCapabilities2KHR; 
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WSI (continued) 


Display Surfaces [29.3.2] 

VkResult vkCreateDisplayPlaneSurfaceKHR( 
Vkinstance instance, 
const VkDisplaySurfaceCreatelnfoKHR* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, [ZY 
VkSurfaceKHR* pSurface); 


typedef struct VkDisplaySurfaceCreatelnfoKHR { 
VkStructureType sType; [XI 
const void* pNext; 
VkDisplaySurfaceCreateFlagsKHR flags; El 
VkDisplayModeKHR displayMode; 
uint32_t planelndex; uint32_t planeStackindex; 
VkSurfaceTransformFlagBitsKHR transform; [XE] 
float globalAlpha; 
VkDisplayPlaneAlphaFlagBitsKHR alphaMode; 
VkExtent2D imageExtent; [JF 
}VkDisplaySurfaceCreatelnfoKHR; 


alphaMode: VK_DISPLAY_PLANE_ALPHA_X_BIT_KHR 
where X is OPAQUE, GLOBAL, PER_PIXEL, 
PER_PIXEL_PREMULTIPLIED 


Querying for WSI Support [29.4] 

VkResult vkGetPhysicalDeviceSurfaceSupportKHR( 
VkPhysicalDevice physicalDevice, 
uint32_t queueFamilylndex, VkSurfaceKHR surface, 
VkBool32* pSupported); 


Wayland Platform Querying [29.4.3] 
VkBool32 
vkGetPhysicalDeviceWaylandPresentationSupportKHR( 
VkPhysicalDevice physicalDevice, 
uint32_t queueFamilylndex, 
struct wl_display* display); 


Win32 Platform Querying [29.4.4] 
VkBool32 
vkGetPhysicalDeviceWin32PresentationSupportKHR( 
VkPhysicalDevice physicalDevice, 
uint32_t queueFamilyindex); 


XCB Platform Querying [29.4.5] 
VkBool32 
vkGetPhysicalDeviceXcbPresentationSupportKHR( 
VkPhysicalDevice physicalDevice, 
uint32_t queueFamilyindex, 
xcb_connection_t* connection, 
xcb_visualid_t visual_id); 


Xlib Platform Querying [29.4.6] 
VkBool32 
vkGetPhysicalDeviceXlibPresentationSupportKHR( 
VkPhysicalDevice physicalDevice, 
uint32_t queueFamilylndex, 
Display* dpy, VisuallD visuallD); 


Surface Queries [29.5] 

VkResult vkGetPhysicalDeviceSurfaceCapabilitiesKHR( 
VkPhysicalDevice physicalDevice, VkSurfaceKHR surface, 
VkSurfaceCapabilitiesKHR* pSurfaceCapabilities); 


VkResult vkGetPhysicalDeviceSurfaceCapabilities2KHR( 
VkPhysicalDevice physicalDevice, 
const VkPhysicalDeviceSurfacelnfo2KHR* pSurfacelnfo, LI 
VkSurfaceCapabilities2KHR* pSurfaceCapabilities); 


typedef struct VkSurfaceCapabilities2KHR { 
VkStructureType sType; ZA 
void* pNext; 
VkSurfaceCapabilitiesKHR surfaceCapabilities; (ZU) 
} VkSurfaceCapabilities2KHR; 
pNext must be NULL or point to: 
VkSharedPresentSurfaceCapabilitiesKHR 


typedef struct VkSharedPresentSurfaceCapabilitiesKHR { 
VkStructureType sType; RA 
void* pNext; 
VkimageUsageFlags 
sharedPresentSupportedUsageFlags; [XE] 
} VkSharedPresentSurfaceCapabilitiesKHR; 


VkResult vkGetPhysicalDeviceSurfaceFormatsKHR( 
VkPhysicalDevice physicalDevice, 
VkSurfaceKHR surface, 
uint32_t* pSurfaceFormatCount, 
VkSurfaceFormatKHR* pSurfaceFormats); 


VkResult vkGetPhysicalDeviceSurfaceFormats2KHR( 
VkPhysicalDevice physicalDevice, 
const VkPhysicalDeviceSurfacelnfo2KHR* pSurfacelnfo, 
uint32_t* pSurfaceFormatCount, 
VkSurfaceFormat2KHR* pSurfaceFormats); 


typedef struct VkSurfaceFormat2KHR { 
VkStructureType sType; ZA 
void* pNext; 
VkSurfaceFormatKHR surfaceFormat; 
} VkSurfaceFormat2KHR; 
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VkResult vkGetPhysicalDeviceSurfacePresentModesKHR( 
VkPhysicalDevice physicalDevice, VkSurfaceKHR surface, 
uint32_t* pPresentModeCount, 

VkPresentModeKHR* pPresentModes); 


pPresentModes: VK_PRESENT_MODE_X_KHR 
where X is IMMEDIATE, MAILBOX, FIFO, FIFO_RELAXED, 
SHARED_DEMAND_REFRESH, 
SHARED_CONTINUOUS_REFRESH 


Device Group Queries [29.6] 

VkResult vkGetDeviceGroupPresentCapabilitiesKHR( 
VkDevice device, 
VkDeviceGroupPresentCapabilitiesKHR* 

pDeviceGroupPresentCapabilities); 


typedef struct VkDeviceGroupPresentCapabilitiesKHR { 
VkStructureType sType; [=] 
const void* pNext; 
uint32_t presentMask[VK_MAX_DEVICE_GROUP_SIZE]; 
VkDeviceGroupPresentModeFlagsKHR modes; EA 
}VkDeviceGroupPresentCapabilitiesKHR; 


VkResult vkGetDeviceGroupSurfacePresentModesKHR( 
VkDevice device, VkSurfaceKHR surface, 
VkDeviceGroupPresentModeFlagsKHR* pModes); 


VkResult vkGetPhysicalDevicePresentRectanglesKHR( 
VkPhysicalDevice physicalDevice, 
VkSurfaceKHR surface, uint32_t* pRectCount, 
VkRect2D* pRects); 


WSI Swapchain [29.7] 

VkResult vkGetSwapchainStatusKHR( 
VkDevice device, 
VkSwapchainKHR swapchain); 


VkResult vkCreateSwapchainKHR( 
VkDevice device, 
const VkSwapchainCreatelnfoKHR* pCreatelnfo, 
const VkAllocationCallbacks* pAllocator, 
VkSwapchainKHR* pSwapchain); 


typedef struct VkSwapchainCreatelnfoKHR { 
VkStructureType sType; BA 
const void* pNext; 
VkSwapchainCreateFlagsKHR flags; 
VkSurfaceKHR surface; uint32_t minlmageCount; 
VkFormat imageFormat; 
VkColorSpaceKHR imageColorSpace; 
VkExtent2D imageExtent; 
uint32_t imageArrayLayers; 
VkimageUsageFlags imageUsage; 
VkSharingMode imageSharingMode; 
uint32_t queueFamilylndexCount; 
const uint32_t* pQueueFamilyindices; 
VkSurfaceTransformFlagBitsKHR preTransform; B 
VkCompositeAlphaFlagBitsKHR compositeAlpha; EA 
VkPresentModeKHR presentMode; 
VkBool32 clipped; VkSwapchainKHR oldSwapchain; 
} VkSwapchainCreatelnfoKHR; 


pNext: may point to struct: 
VkDeviceGroupSwapchainCreatelnfoKHR 


flags: VK_SWAPCHAIN_CREATE_X_KHR where X is 
SPLIT_INSTANCE_BIND_REGIONS, PROTECTED 


colorSpace: VK_COLOR_SPACE_SRGB_NONLINEAR_KHR 


presentMode: VK_PRESENT_MODE_X_KHR 
where X is IMMEDIATE, MAILBOX, FIFO, FIFO_RELAXED, 
DEMAND_REFRESH, CONTINUOUS_REFRESH 


typedef struct VkDeviceGroupSwapchainCreatelnfoKHR { 
VkStructureType sType; RA 
const void* pNext; 
VkDeviceGroupPresentModeFlagsKHR modes; 
}VkDeviceGroupSwapchainCreatelnfoKHR; 


modes: VK_DEVICE_GROUP_ PRESENT MODE _X_BIT_KHR 
where X is LOCAL, REMOTE, SUM, LOCAL_ MULTI DEVICE 


void vkDestroySwapchainKHR( 
VkDevice device, VkSwapchainKHR swapchain, 
const VkAllocationCallbacks* pAllocator); EA 


VkResult vkCreateSharedSwapchainsKHR( 
VkDevice device, 
uint32_t swapchainCount, 
const VkSwapchainCreatelnfoKHR* pCreatelnfos, 
const VkAllocationCallbacks* pAllocator, 
VkSwapchainKHR* pSwapchains); 


VkResult vkGetSwapchainimagesKHR( 
VkDevice device, VkSwapchainKHR swapchain, 
uint32_t* pSwapchainlmageCount, 
Vkimage* pSwapchainlmages); 


VkResult vkAcquireNextImageKHR( 
VkDevice device, VkSwapchainKHR swapchain, 
uint64_t timeout, VkSemaphore semaphore, 
VkFence fence, 
uint32_t* plmagelndex); 


VkResult vkAcquireNextimage2KHR( 
VkDevice device, 
const VkAcquireNextimagelnfoKHR* pAcquirelnfo, 
uint32_t* plmagelndex); 


typedef struct VkAcquireNextimagelnfoKHR { 
VkStructureType sType; const void* pNext; 
VkSwapchainKHR swapchain; uint64_t timeout; 
VkSemaphore semaphore; 
VkFence fence; uint32_t deviceMask; 

} VkAcquireNextimagelnfoKHR; 


VkResult vkQueuePresentKHR( 
VkQueue queue, 
const VkPresentinfoKHR* pPresentinfo); 


typedef struct VkPresentinfoKHR { 
VkStructureType sType; 
const void* pNext; uint32_t waitSemaphoreCount; 
const VkSemaphore* pWaitSemaphores; 
uint32_t swapchainCount; 
const VkSwapchainKHR* pSwapchains; 
const uint32_t* plmagelndices; VkResult* pResults; 
} VkPresentInfoKHR; 
pNext must be NULL or point to one of: 
VkDeviceGroupPresentinfoKHR, 
VkDisplayPresentinfoKHR, or VkPresentRegionsKHR 


typedef struct VkDeviceGroupPresentinfoKHR { 
VkStructureType sType; 
const void* pNext; uint32_t swapchainCount; 
const uint32_t* pDeviceMasks; 
VkDeviceGroupPresentModeFlagBitsKHR mode; 
} VkDeviceGroupPresentInfoKHR; 
mode: VK_DEVICE_GROUP_PRESENT_MODE_X_BIT_KHR 
where X is REMOTE, SUM, LOCAL, LOCAL_MULTI_ DEVICE 


typedef struct VkDisplayPresentinfoKHR { 
VkStructureType sType; const void* pNext; 
VkRect2D srcRect; 
VkRect2D dstRect; RA 
VkBool32 persistent; 

} VkDisplayPresentInfoKHR; 


typedef struct VkPresentRegionsKHR { 
VkStructureType sType; 
const void* pNext; uint32_t swapchainCount; 
const VkPresentRegionKHR* pRegions; 

} VkPresentRegionsKHR; 


typedef struct VkPresentRegionKHR { 
uint32_t rectangleCount; 
const VkRectLayerKHR* pRectangles; 
} VkPresentRegionKHR; 


typedef struct VkRectLayerKHR { 
VkOffset2D offset; 
VkExtent2D extent; 
uint32_t layer; 

} VkRectLayerKHR; 


typedef struct VkDisplayPresentiInfoKHR { 
VkStructureType sType; const void* pNext; 
VkRect2D srcRect; 
VkRect2D dstRect; 
VkBool32 persistent; 

} VkDisplayPresentInfoKHR; 


Extended Functionality 


Layers [30.1] 

VkResult vkEnumeratelnstanceLayerProperties( 
uint32_t* pPropertyCount, 
VkLayerProperties* pProperties); 


VkResult vkEnumerateDeviceLayerProperties( 
VkPhysicalDevice physicalDevice, 
uint32_t* pPropertyCount, 
VkLayerProperties* pProperties); 


typedef struct VkLayerProperties { 
char layerName [VK_MAX_EXTENSION_NAME_SIZE]; 
uint32_t specVersion; 
uint32_t implementationVersion; 
char description [VK_MAX_DESCRIPTION_SIZE]; 
} VkLayerProperties; 


Extensions [30.2] 

VkResult vkEnumeratelnstanceExtensionProperties( 
const char* pLayerName, 
uint32_t* pPropertyCount, 
VkExtensionProperties* pProperties); 


VkResult vkEnumerateDeviceExtensionProperties( 
VkPhysicalDevice physicalDevice, 
const char* pLayerName, 
uint32_t* pPropertyCount, 
VkExtensionProperties* pProperties); 
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Extended Functionality (continued) 
typedef struct VkExtensionProperties { 


char extensionName [VK_MAX_EXTENSION_NAME_SIZE]; 


uint32_t specVersion; 
} VkExtensionProperties; 


Additional Buffer Capabilities [31.5] 
void vkGetPhysicalDeviceExternalBufferProperties( 
VkPhysicalDevice physicalDevice, 
const VkPhysicalDeviceExternalBufferInfo* 
pExternalBufferinfo, 
VkExternalBufferProperties* 
pExternalBufferProperties); 


typedef struct VkPhysicalDeviceExternalBufferinfo { 
VkStructureType sType; ZA 
const void* pNext; 
VkBufferCreateFlags flags; BA 
VkBufferUsageFlags usage; 
VkExternalMemoryHandleTypeFlagBits handleType; EA 
} VkPhysicalDeviceExternalBufferInfo; 


typedef struct VkExternalBufferProperties { 
VkStructureType sType; ZA 
void* pNext; 
VkExternalMemoryProperties 
externalMemoryProperties; 
} VkExternalBufferProperties; 


Features, Limits, and Formats [31] 


Features [31.1] 

void vkGetPhysicalDeviceFeatures( 
VkPhysicalDevice physicalDevice, 
VkPhysicalDeviceFeatures* pFeatures); 


void vkGetPhysicalDeviceFeatures2( 
VkPhysicalDevice physicalDevice, 
VkPhysicalDeviceFeatures2* pFeatures); [EU] 


Format Properties [31.3.2] 

void vkGetPhysicalDeviceFormatProperties( 
VkPhysicalDevice physicalDevice, 
VkFormat format, 
VkFormatProperties* pFormatProperties); 


typedef struct VkFormatProperties { 
VkFormatFeatureFlags /inearTilingFeatures; 
VkFormatFeatureFlags optimalTilingFeatures; 
VkFormatFeatureFlags bufferFeatures; 

} VkFormatProperties; 


enum VkFormatFeatureFlagBits: 

VK_FORMAT_FEATURE_X BIT where X is 

SAMPLED_IMAGE, STORAGE_IMAGE[_ATOMIC], 

UNIFORM_TEXEL_BUFFER, 

STORAGE_TEXEL_BUFFER[_ATOMIC], 

VERTEX_BUFFER, COLOR_ATTACHMENT[_BLEND], 

DEPTH_STENCIL_ATTACHMENT, 

SAMPLED_IMAGE_FILTER_LINEAR, DISJOINT, 

BLIT_{SRC, DST}, TRANSFER_{SRC, DST}, 

{MIDPOINT, COSITED}_ CHROMA_SAMPLES, 

and VK_FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_- 

CONVERSION_X where X is LINEAR_FILTER, 
SEPARATE_RECONSTRUCTION_FILTER, 
CHROMA_RECONSTRUCTION_EXPLICIT, 
CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE 


Optional Semaphore Capabilities [31.6] 
void vkGetPhysicalDeviceExternalSemaphoreProperties( 
VkPhysicalDevice physicalDevice, 
const VkPhysicalDeviceExternalSemaphorelnfo* 
pExternalSemaphorelnfo, 
VkExternalSemaphoreProperties* 
pExternalSemaphoreProperties); 


typedef struct VkPhysicalDeviceExternalSemaphorelnfo { 
VkStructureType sType; ZA 
const void* pNext; 
VkExternalSemaphoreHandleTypeFlagBits 
handleType; 
} VkPhysicalDeviceExternalSemaphorelnfo; 


enum VkExternalSemaphoreHandleTypeFlagBits: 
VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_X_BIT 
where X is OPAQUE_FD, 
OPAQUE_WIN32[_KMT], 
D3D12_FENCE, SYNC_FD 


typedef struct VkExternalSemaphoreProperties { 
VkStructureType sType; ZH 
void* pNext; 
VkExternalSemaphoreHandleTypeFlags 
exportFromimportedHandleTypes; 
VkExternalSemaphoreHandleTypeFlags 
compatibleHandleTypes; 
VkExternalSemaphoreFeatureFlags 
externalSemaphoreFeatures; 
} VkExternalSemaphoreProperties; 


VkExternalSemaphoreFeatureFlagBits: 
VK_EXTERNAL_SEMAPHORE_FEATURE_X_BIT where X is 
EXPORTABLE, IMPORTABLE 


void vkGetPhysicalDeviceFormatProperties2( 
VkPhysicalDevice physicalDevice, 
VkFormat format, [KE] 
VkFormatProperties2* pFormatProperties); 


typedef struct VkFormatProperties2 { 
VkStructureType sType; 
void* pNext; 
VkFormatProperties formatProperties; 
} VkFormatProperties2; 


Additional Image Capabilities [31.4] 
VkResult vkGetPhysicalDevicelmageFormatProperties( 
VkPhysicalDevice physicalDevice, 
VkFormat format, [KE] 
VklmageType type, 
VkImageTiling tiling, [XE] 
VkimageUsageFlags usage, 
VkImageCreateFlags flags, [X=] 
VkImageFormatProperties* p/mageFormatProperties); 


typedef struct VkimageFormatProperties { 
VkExtent3D maxExtent; 
uint32_t maxMipLevels; 
uint32_t maxArrayLayers; 
VkSampleCountFlags sampleCounts; [XE] 
VkDeviceSize maxResourceSize; 

} VklmageFormatProperties; 


VkResult vkGetPhysicalDevicelmageFormatProperties2( 
VkPhysicalDevice physicalDevice, 
const VkPhysicalDevicelmageFormatinfo2* 
plmageFormatinfo, 
VkimageFormatProperties2* plmageFormatProperties); 


Optional Fence Capabilities [31.7] 
void vkGetPhysicalDeviceExternalFenceProperties( 
VkPhysicalDevice physicalDevice, 
const VkPhysicalDeviceExternalFencelnfo* 
pExternalFencelnfo, 
VkExternalFenceProperties* pExternalFenceProperties); 


typedef struct VkPhysicalDeviceExternalFencelnfo { 
VkStructureType sType; BE 
const void* pNext; 
VkExternalFenceHandleTypeFlagBits handleType; EA 
} VkPhysicalDeviceExternalFencelnfo; 


typedef struct VkExternalFenceProperties { 
VkStructureType sType; BH 
void* pNext; 
VkExternalFenceHandleTypeFlags 
exportFromimportedHandleTypes; EA 
VkExternalFenceHandleTypeFlags 
compatibleHandleTypes; EA 
VkExternalFenceFeatureFlags externalFenceFeatures; 
} VkExternalFenceProperties; 


enum VkExternalFenceFeatureFlagBits: 
VK_EXTERNAL_FENCE_FEATURE_X_BIT where X is 
EXPORTABLE, IMPORTABLE 


typedef struct VklmageFormatProperties2 { 
VkStructureType sType; 
void* pNext; 
VkimageFormatProperties imageFormatProperties; 
} VklmageFormatProperties2; 
pNext must be NULL or point to: 
VkExternallmageFormatProperties [FF 
VkSamplerYcbcrConversionImageFormatProperties LEE] 


typedef struct VkPhysicalDevicelmageFormatinfo2 { 
VkStructureType sType; 
const void* pNext; 
VkFormat format, 
VkimageType type, [EE] 
VkimageTiling tiling, [XE] 
VklmageUsageFlags usage, 
VkimageCreateFlags flags, 
} VkPhysicalDevicelmageFormatInfo2; 
pNext must be NULL or point to: 
VkPhysicalDeviceExternallmageFormatinfo A 
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Structures and Enumerations 
This section contains an alphabetic reference to types enums 
and structs referenced in multiple places on preceding pages. 


enum VkAccessFlagBits: 
VK_ACCESS_X_BIT where X is 
INDIRECT_COMMAND_READ, 
INDEX_READ, 
VERTEX_ATTRIBUTE_READ, 
UNIFORM_READ, 
INPUT_ATTACHMENT_READ, 
SHADER_[READ, WRITE], 
COLOR_ATTACHMENT_[READ, WRITE], 
DEPTH_STENCIL_ATTACHMENT_[READ, WRITE], 
TRANSFER_[READ, WRITE], 
HOST_[READ, WRITE], 
MEMORY_[READ, WRITE] 


typedef struct VkAllocationCallbacks { 
void* pUserData; 
PFN_vkAllocationFunction pfnAllocation; 
PFN_vkReallocationFunction pfnReallocation; 
PFN_vkFreeFunction pfnFree; 
PFN_vkinternalAllocationNotification 
pfninternalAllocation; 
PFN_vkInternalFreeNotification pfninternalFree; 
} VkAllocationCallbacks; 


typedef void* (VKAPI_PTR* PFN_vkAllocationFunction)( 
void* pUserData, 
size_t size, 
size_t alignment, 
VkSystemAllocationScope allocationScope); 


typedef void* (VKAPI_PTR* PFN_vkReallocationFunction)( 
void* pUserData, 
void* pOriginal, 
size_t size, 
size_t alignment, 
VkSystemAllocationScope allocationScope); 


typedef void (VKAPI_PTR* PFN_vkFreeFunction)( 
void* pUserData, 
void* pMemory); 


typedef void ( 
VKAPI_PTR* PFN_vkinternalAllocationNotification)( 
void* pUserData, 
size_t size, 
VkinternalAllocationType allocationType, 
VkSystemAllocationScope allocationScope); 


typedef void ( 
VKAPI_PTR* PFN_vkinternalFreeNotification)( 
void* pUserData, 
size_t size, 
VkinternalAllocationType allocationType, 
VkSystemAllocationScope allocationScope); 


allocationType: 
VK_INTERNAL_ALLOCATION_TYPE_EXECUTABLE 


allocationScope: VK_SYSTEM_ALLOCATION_SCOPE_X where 
X is COMMAND, OBJECT, CACHE, DEVICE, INSTANCE 


typedef struct VkBindBufferMemoryDeviceGroupInfo { 
VkStructureType sType; 
const void* pNext; uint32_t devicelndexCount; 
const uint32_t* pDevicelndices; 

} VkBindBufferMemoryDeviceGroupInfo; 


typedef struct VkBindImageMemoryDeviceGroupInfo { 
VkStructureType sType; TEE) 
const void* pNext; uint32_t devicelndexCount; 
const uint32_t* pDevicelndices; 
uint32_t splitinstanceBindRegionCount; 
const VkRect2D* pSplitinstanceBindRegions; EH 
} VkBindimageMemoryDeviceGrouplinfo; 


typedef struct VkBindImagePlaneMemoryinfo { 
VkStructureType sType; BA 
const void* pNext; 
VkimageAspectFlagBits planeAspect; 

} VkBindimagePlaneMemoryinfo; 


enum VkBlendOp: 
VK_BLEND_OP_ADD, 
VK_BLEND_OP_SUBTRACT, 
VK_BLEND_OP_REVERSE_SUBTRACT, 
VK_BLEND_OP_MIN, 
VK_BLEND_OP_MAX 


enum VkBufferCreateFlagBits: 
VK_BUFFER_CREATE_SPARSE_BINDING_BIT, 
VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT, 
VK_BUFFER_CREATE_SPARSE_ALIASED_BIT, 
VK_BUFFER_CREATE_PROTECTED_BIT 
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typedef struct VkBufferMemoryBarrier { 
VkStructureType sType; 
const void* pNext; 
VkAccessFlags srcAccessMask; 
VkAccessFlags dstAccessMask; 
uint32_t srcQueueFamilyindex; 
uint32_t dstQueueFamilyindex; 
VkBuffer buffer; 
VkDeviceSize offset; VkDeviceSize size; 
} VkBufferMemoryBarrier; 


enum VkBufferUsageFlagBits: 
VK_BUFFER_USAGE_X_BIT where X is 
TRANSFER_SRC, TRANSFER_DST, 
UNIFORM_TEXEL_BUFFER, STORAGE_TEXEL_BUFFER, 
UNIFORM_BUFFER, STORAGE_BUFFER, INDEX_BUFFER, 
VERTEX_BUFFER, INDIRECT_BUFFER 


typedef union VkClearColorValue { 
float float32[4]; 
int32_t int32[4]; 
uint32_t uint32[4]; 

} VkClearColorValue; 


typedef struct VkClearDepthStencilValue { 
float depth; 
uint32_t stencil; 

} VkClearDepthStencilValue; 


typedef union VkClearValue { 
VkClearColorValue color; BA 
VkClearDepthStencilValue depthStencil; 
} VkClearValue; 


enum VkCompareOp: 
VK_COMPARE_OP_X where X is 
NEVER, LESS, EQUAL, 
LESS_OR_EQUAL, 
GREATER, 
NOT_EQUAL, 
GREATER_OR_EQUAL, 
ALWAYS 


enum VkCompositeAlphaFlagBitsKHR: 
VK_COMPOSITE_ALPHA_X_BIT_KHR where X is 
OPAQUE, PRE_MULTIPLIED, POST_MULTIPLIED, INHERIT 


enum VkDependencyFlagBits: 
VK_DEPENDENCY_BY_REGION_BIT, 
VK_DEPENDENCY_DEVICE_GROUP_BIT, 
VK_DEPENDENCY_VIEW_LOCAL_BIT 


enum VkDescriptorType: 
VK_DESCRIPTOR_TYPE_X where X is 
SAMPLER, COMBINED_IMAGE_SAMPLER, 
SAMPLED_IMAGE, STORAGE_IMAGE, 
UNIFORM_TEXEL_BUFFER, 
STORAGE_TEXEL_BUFFER, 
UNIFORM_BUFFER[_DYNAMIC], 
STORAGE_BUFFER[_DYNAMIC], 
INPUT_ATTACHMENT 


typedef struct VkDescriptorSetLayoutBinding { 
uint32_t binding; 
VkDescriptorType descriptorType; 
uint32_t descriptorCount; 
VkShaderStageFlags stageFlags; 
const VkSampler* pimmutableSamplers; 

} VkDescriptorSetLayoutBinding; 


typedef struct VkDescriptorSetLayoutCreatelnfo { 
VkStructureType sType; ZA 
const void* pNext; 
VkDescriptorSetLayoutCreateFlags flags; 
uint32_t bindingCount; 
const VkDescriptorSetLayoutBinding* pBindings; 
} VkDescriptorSetLayoutCreatelnfo; 


typedef struct VkDeviceGroupBindSparselnfo { 
VkStructureType sType; BH 
const void* pNext; 
uint32_t resourceDevicelndex; 
uint32_t memoryDevicelndex; 
} VkDeviceGroupBindSparselnfo; 


typedef struct VkDeviceGroupCommandBufferBegininfo { 
VkStructureType sType; 
const void* pNext; 
uint32_t deviceMask; 

} VkDeviceGroupCommandBufferBeginInfo; 


typedef struct VkDeviceGroupDeviceCreatelnfo { 
VkStructureType sType; 
const void* pNext; uint32_t physicalDeviceCount; 
const VkPhysicalDevice* pPhysicalDevices; 

} VkDeviceGroupDeviceCreatelnfo; 


enum VkDeviceGroupPresentModeFlagBitsKHR: 


VK_DEVICE_GROUP_PRESENT_MODE_X_BIT_KHR where X is 
LOCAL, REMOTE, SUM, LOCAL. MULTI DEVICE 


typedef struct VkDeviceGroupRenderPassBeginInfo { 
VkStructureType sType; 
const void* pNext; uint32_t deviceMask; 
uint32_t deviceRenderAreaCount; 
const VkRect2D* pDeviceRenderAreas; 
} VkDeviceGroupRenderPassBeginInfo; 


typedef struct VkDeviceGroupSubmitinfo { 
VkStructureType sType; [==] 
const void* pNext; 
uint32_t waitSemaphoreCount; 
const uint32_t* pWaitSemaphoreDevicelndices; 
uint32_t commandBufferCount; 
const uint32_t* pCommandBufferDeviceMasks; 
uint32_t signalSemaphoreCount; 
const uint32_t* pSignalSemaphoreDevicelndices; 
} VkDeviceGroupSubmitinfo; 


typedef struct VkExportFenceCreatelnfo { 
VkStructureType sType; EEE 
const void* pNext; 
VkExternalFenceHandleTypeFlags handleTypes; 
} VkExportFenceCreatelnfo; 


typedef struct VkExportMemoryAllocatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkExternalMemoryHandleTypeFlags handleTypes; EA 
} VkExportMemoryAllocatelnfo; 


typedef struct VkExportSemaphoreCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkExternalSemaphoreHandleTypeFlags handleTypes; 
} VkExportSemaphoreCreatelnfo; 


typedef struct VkExtent2D { 
uint32_t width; 
uint32_t height; 

} VkExtent2D; 


typedef struct VkExtent3D { 
uint32_t width; 
uint32_t height; 
uint32_t depth; 

} VkExtent3D; 


enum VkExternalFenceHandleTypeFlagBits: 
VK_EXTERNAL_FENCE_HANDLE_TYPE_X_BIT where X is 
OPAQUE_FD, 
OPAQUE_WIN32, 
OPAQUE_WIN32_KMT, 
SYNC_FD 


typedef struct VkExternallmageFormatProperties { 
VkStructureType sType; 
void* pNext; 
VkExternalMemoryProperties 
externalMemoryProperties; [JE] 
} VkExternallmageFormatProperties; 


typedef struct VkExternalMemoryBufferCreatelnfo { 
VkStructureType sType; EX 
const void* pNext; 
VkExternalMemoryHandleTypeFlags handleTypes; EA 
} VkExternalMemoryBufferCreatelnfo; 


enum VkExternalMemoryFeatureFlagBits: 
VK_EXTERNAL_MEMORY_FEATURE_X_BIT where X is 
DEDICATED_ONLY, 
EXPORTABLE, 
IMPORTABLE 


enum VkExternalMemoryHandleTypeFlagBits: 
VK_EXTERNAL_MEMORY_HANDLE_TYPE_X_BIT where X is 
OPAQUE_FD, 
OPAQUE_WIN32, 
OPAQUE_WIN32_KMT, 
D3D11_TEXTURE, 
D3D11_TEXTURE_KMT, 
D3D12_HEAP, 
D3D12_RESOURCE 
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typedef struct VkExternalMemorylmageCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkExternalMemoryHandleTypeFlags handle Types; 
} VkExternalMemorylmageCreatelnfo; 


typedef struct VkExternalMemoryProperties { 
VkExternalMemoryFeatureFlags 
externalMemoryFeatures; 
VkExternalMemoryHandleTypeFlags 
exportFromImportedHandleTypes; 
VkExternalMemoryHandleTypeFlags 
compatibleHandleTypes; 
} VkExternalMemoryProperties; 


enum VkExternalSemaphoreHandleTypeFlagBits: 
VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_X_BIT where 
X is OPAQUE_FD, OPAQUE_WIN32, OPAQUE_WIN32_KMT, 
D3D12_FENCE, SYNC_FD 


enum VkFormat: 
VK_FORMAT_X where X is 
UNDEFINED, 
R4G4_UNORM_PACK8, 
R4G4B4A4_UNORM_PACK16, 
B4G4R4A4_UNORM_PACK16, 
R5G6B5_UNORM_PACK16, 
B5G6R5_UNORM_PACK16, 
R5G5B5A1_UNORM_PACK16, 
B5G5R5A1_UNORM_PACK16, 
A1R5G5B5_UNORM_PACK16, 
R8_[UNORM, SNORM, USCALED], 
R8_[SSCALED, UINT, SINT, SRGB], 
R8G8_[UNORM, SNORM, USCALED], 
R8G8_[SSCALED, UINT, SINT, SRGB], 
R8G8B8_[UNORM, SNORM, USCALED], 
R8G8B8_[SSCALED, UINT, SINT, SRGB], 
B8G8R8_[UNORM, SNORM, USCALED], 
B8G8R8_[SSCALED, UINT, SINT, SRGB], 
R8G8B8A8_[UNORM, SNORM, USCALED], 
R8G8B8A8_[SSCALED, UINT, SINT, SRGB], 
B8G8R8A8_[UNORM, SNORM, USCALED], 
B8G8R8A8_[SSCALED, UINT, SINT, SRGB], 
A8B8G8R8_[UNORM, SNORM, USCALED]_PACK32, 
A8B8G8R8_[SSCALED, UINT, SINT, SRGB]_PACK32, 
A2R10G10B10_[UNORM, SNORM, USCALED]_PACK32, 
A2R10G10B10_[SSCALED, UINT, SINT]_PACK32, 
A2B10G10R10_[UNORM, SNORM, USCALED]_PACK32, 
A2B10G10R10_[SSCALED, UINT, SINT]_PACK32, 
R16_[UNORM, SNORM, USCALED], 
R16_[SSCALED, UINT, SINT, SFLOAT], 
R16G16_[UNORM, SNORM, USCALED], 
R16G16_[SSCALED, UINT, SINT, SFLOAT], 
R16G16B16_[UNORM, SNORM, USCALED], 
R16G16B16_[SSCALED, UINT, SINT, SFLOAT], 
R16G16B16A16_[UNORM, SNORM, USCALED], 
R16G16B16A16_[SSCALED, UINT, SINT, SFLOAT], 
R32_[UINT, SINT, SFLOAT], 
R32G32_[UINT, SINT, SFLOAT], 
R32G32B32_[UINT, SINT, SFLOAT], 
R32G32B32A32_[UINT, SINT, SFLOAT], 
R64_[UINT, SINT, SFLOAT], 
R64G64_[UINT, SINT, SFLOAT], 
R64G64B64_[UINT, SINT, SFLOAT], 
R64G64B64A64_[UINT, SINT, SFLOAT], 
B10G11R11_UFLOAT_PACK32, 
E5B9G9R9_UFLOAT_PACK32, 
X8_D24_UNORM_PACK32, 
D32_SFLOAT[_S8_UINT], 
S8_UINT, 
D[16, 24]_UNORM_S8_UINT, 
BC1_[RGB, RGBA]_UNORM_BLOCK, 
BC1_[RGB, RGBA]_SRGB_BLOCK, 
BC2_[UNORM, SRGB]_BLOCK, 
BC3_[UNORM, SRGB]_BLOCK, 
BC4_[UNORM, SRGB]_BLOCK, 
BC5_[UNORM, SRGB]_ BLOCK, 
BC6H_[UFLOAT, SFLOAT]_BLOCK, 
BC7_[UNORM, SRGB]_BLOCK, 
ETC2_R8G8B8_[UNORM, SRGB]_BLOCK, 
ETC2_R8G8B8A1_[UNORM, SRGB]_BLOCK, 
ETC2_R8G8B8A8_[UNORM, SRGB]_BLOCK, 
EAC_R11_[UNORM, SRGB]_ BLOCK, 
EAC_R11G11_[UNORM, SRGB]_BLOCK, 
ASTC_4x4_[UNORM, SRGB]_BLOCK, 
ASTC_5x4_[UNORM, SRGB]_BLOCK, 
ASTC_5x5_[UNORM, SRGB]_ BLOCK, 
ASTC_6x5_[UNORM, SRGB]_ BLOCK, 
ASTC_6x6_[UNORM, SRGB]_BLOCK, 
ASTC_8x5_[UNORM, SRGB]_BLOCK, 
ASTC_8x6_[UNORM, SRGB]_BLOCK, 
ASTC_8x8_[UNORM, SRGB]_BLOCK, 
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ASTC_10x5_[UNORM, SRGB]_BLOCK, 
ASTC_10x6_[UNORM, SRGB]_BLOCK, 
ASTC_10x8_[UNORM, SRGB]_BLOCK, 
ASTC_10x10_[UNORM, SRGB]_BLOCK, 
ASTC_12x10_[UNORM, SRGB]_BLOCK, 
ASTC_12x12_[UNORM, SRGB]_BLOCK, 
G8B8G8R8_422_UNORM, 

B8G8R8G8 422 UNORM, 
G8_B8_R8_3PLANE_420_UNORM, 
G8_B8R8_2PLANE_{420, 422} UNORM, 
G8_B8_R8_3PLANE {422, 444} UNORM, 
R10X6_UNORM_PACK16, 
R10X6G10X6_UNORM_2PACK16, 
R10X6G10X6B10X6A10X6_UNORM_4PACK16, 
G10X6B10X6G10X6R10X6_422_UNORM_4PACK16, 
B1OX6G10X6R10X6G10X6_422_UNORM_4PACK16, 
G10X6_B10X6_R10X6_3PLANE 420 UNORM_3PACK16, 
G10X6_B10X6R10X6_2PLANE 420 UNORM_3PACK16, 
G10X6_B10X6_R10X6_3PLANE 422 UNORM_3PACK16, 
G10X6_B10X6R10X6_2PLANE 422 UNORM_3PACK16, 
G10X6_B10X6_R10X6_3PLANE 444 UNORM_3PACK16, 
R12X4_UNORM_PACK16, 
R12X4G12X4_UNORM_2PACK16, 
R12X4G12X4B12X4A12X4 UNORM_4PACK16, 
G12X4B12X4G12X4R12X4 422 UNORM_4PACK16, 
B12X4G12X4R12X4G12X4 422 UNORM 4PACK16, 
G12X4_ B12X4 R12X4 3PLANE 420 UNORM_3PACK16, 


G12X4_B12X4R12X4_2PLANE_{420, 422} UNORM_3PACK16, 


G12X4_B12X4_R12X4_3PLANE_422_UNORM_3PACK16, 
G12X4_B12X4_R12X4_3PLANE_444_UNORM_3PACK16, 
G16B16G16R16_422 UNORM, 
B16G16R16G16 422 UNORM, 
G16_B16_R16_3PLANE_{420, 422, 444} UNORM, 
G16_B16R16_2PLANE_{420, 422} UNORM 


enum VkimageAspectFlagBits: 
VK_IMAGE_ASPECT_X_BIT where X is 
COLOR, DEPTH, STENCIL, METADATA, PLANE_[0,1,2] 


enum VkImageCreateFlagBits: 
VK_IMAGE_CREATE_X_BIT where X is 
SPARSE_{BINDING, RESIDENCY, ALIASED}, 
MUTABLE_FORMAT, 
{CUBE, 2D_ARRAY, TEXEL_VIEW} COMPATIBLE, 
ALIAS, BIND_SFR, 
EXTENDED_USAGE, 
PROTECTED, 
DISJOINT 


enum VkImageLayout: 
VK_IMAGE_LAYOUT_X where X is 
UNDEFINED, GENERAL, PREINITIALIZED, 
COLOR_ATTACHMENT_OPTIMAL, 
DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL, 
DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL, 
DEPTH_STENCIL_ATTACHMENT_OPTIMAL, 
DEPTH_STENCIL_READ_ONLY_OPTIMAL, 
SHADER_READ_ONLY_OPTIMAL, 
TRANSFER_{SRC, DST}_OPTIMAL, 
DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL, 
DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL, 
VK_IMAGE_LAYOUT_PRESENT_SRC_KHR, 
VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR 


NOTE: For the functions vkCmdCopylmage, 
vkCmdCopyBufferTolmage, vkCmdCopylmageToBuffer, 
vkCmdBlitimage, and vkCmdResolvelmage, the enum 
VkImageLayout for the following parameters may be: 
srclmageLayout: VK_IMAGE_LAYOUT_GENERAL, 
VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL, 
VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR 
dstimageLayout: VK_IMAGE_LAYOUT_GENERAL, 
VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL, 
VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR 


typedef struct VklmageMemoryBarrier { 
VkStructureType sType; 
const void* pNext; 
VkAccessFlags srcAccessMask; 
VkAccessFlags dstAccessMask; 
VkimageLayout o/dLayout; 
VkimageLayout newLayout; [==] 
uint32_t srcQueueFamilyindex; 
uint32_t dstQueueFamilyindex; 
VkImage image; 
VkimageSubresourceRange subresourceRange; [EE] 
} VkImageMemoryBarrier; 


typedef struct VkimagePlaneMemoryRequirementsinfo { 
VkStructureType sType; [AXE 
const void* pNext; 
VkimageAspectFlagBits planeAspect; EEE] 
}VkimagePlaneMemoryRequirementsinfo; 


typedef struct VkimageSubresourceLayers { 
VkimageAspectFlags aspectMask; 
uint32_t mipLevel; 
uint32_t baseArrayLayer; 
uint32_t layerCount; 

} VklmageSubresourceLayers; 


typedef struct VkimageSubresourceRange { 
VkimageAspectFlags aspectMask; 
uint32_t baseMipLevel; 
uint32_t levelCount; 
uint32_t baseArrayLayer; 
uint32_t layerCount; 

} VklmageSubresourceRange; 


enum VkimageTiling: 
VK_IMAGE_TILING_{OPTIMAL, LINEAR} 


enum VkImageType: 
VK_IMAGE_TYPE_{1D, 2D, 3D} 


enum VkIlmageUsageFlagBits: 
VK_IMAGE_USAGE_X_BIT where X is 
TRANSFER_SRC, 
TRANSFER_DST, 
SAMPLED, 
STORAGE, 
COLOR_ATTACHMENT, 
DEPTH_STENCIL_ATTACHMENT, 
TRANSIENT_ATTACHMENT, 
INPUT_ATTACHMENT 


typedef struct VkimageViewUsageCreatelnfo { 
VkStructureType sType; EA 
const void* pNext; 
VkimageUsageFlags usage; [AE] 

} VklmageViewUsageCreatelnfo; 


typedef struct VkInputAttachmentAspectReference { 
uint32_t subpass; 
uint32_t inputAttachmentindex; 
VkImageAspectFlags aspectMask; [XE] 

} VkInputAttachmentAspectReference; 


typedef struct VkMemoryAllocateFlagsinfo { 
VkStructureType sType; BA 
const void* pNext; 
VkMemoryAllocateFlags flags; 
uint32_t deviceMask; 
}VkMemoryAllocateFlagsinfo; 


flags: VK_MEMORY_ALLOCATE_ DEVICE MASK_BIT 


typedef struct VkMemoryBarrier { 
VkStructureType sType; BA 
const void* pNext; 
VkAccessFlags srcAccessMask; 
VkAccessFlags dstAccessMask; 
} VkMemoryBarrier; 


typedef struct VkMemoryDedicatedAllocatelnfo { 
VkStructureType sType; BA 
const void* pNext; 
Vkimage image; VkBuffer buffer; 
}VkMemoryDedicatedAllocatelnfo; 


typedef struct VkMemoryDedicatedRequirements { 
VkStructureType sType; BE 
void* pNext; 
VkBool32 prefersDedicatedAllocation; 
VkBool32 requiresDedicatedAllocation; 
} VkMemoryDedicatedRequirements; 


typedef struct VkMemoryHeap { 
VkDeviceSize size; 
VkMemoryHeapFlags flags; 
} VkMemoryHeap; 
flags: VK_MEMORY_HEAP_X_BIT where X is 
DEVICE_LOCAL, MULTI_INSTANCE 


typedef struct VkMemoryRequirements { 
VkDeviceSize size; 
VkDeviceSize alignment; 
uint32_t memoryTypeBits; 

} VkMemoryRequirements; 


typedef struct VkMemoryRequirements2 { 
VkStructureType sType; EA 
void* pNext; 
VkMemoryRequirements memoryRequirements; EE] 
} VkMemoryRequirements2; 
pNext must be NULL or point to: 
VkMemoryDedicatedRequirements 
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typedef struct VkMemoryType { 
VkMemoryPropertyFlags propertyFlags; 
uint32_t heapindex; 

} VkMemoryType; 


propertyFlags: VK_MEMORY_PROPERTY_X_BIT where X is 
DEVICE_LOCAL, HOST_VISIBLE, HOST_COHERENT, 
HOST_CACHED, LAZILY_ALLOCATED, PROTECTED 


typedef struct VkOffset2D { 
Meria 
int32_t y; 

} VkOffset2D; 


typedef struct VkOffset3D { 
int32_t x; 
int32_t y; 
int32_t z; 

} VkOffset3D; 


typedef struct VkPhysicalDevice16BitStorageFeatures { 
VkStructureType sType; 
void* pNext; 
VkBool32 storageBuffer16BitAccess; 
VkBool32 uniformAndStorageBuffer16BitAccess; 
VkBool32 storagePushConstant16; 
VkBool32 storagelnputOutput16; 

} VkPhysicalDevice16BitStorageFeatures; 


typedef struct VkPhysicalDeviceExternallmageFormatinfo { 
VkStructureType sType; BA 
const void* pNext; 
VkExternalMemoryHandleTypeFlagBits handleType; 
} VkPhysicalDeviceExternallmageFormatinfo; 


typedef struct VkPhysicalDeviceFeatures { 
VkBool32 robustBufferAccess; 
VkBool32 fullDrawindexUint32; 
VkBool32 imageCubeArray; 
VkBool32 independentBlend; 
VkBool32 geometryShader; 
VkBool32 tessellationShader; 
VkBool32 sampleRateShading; 
VkBool32 dualSrcBlend; 
VkBool32 logicOp; 
VkBool32 multiDrawindirect; 
VkBool32 drawindirectFirstinstance; 
VkBool32 depthClamp; 
VkBool32 depthBiasClamp; 
VkBool32 fillModeNonSolid; 
VkBool32 depthBounds; 
VkBool32 wideLines; 
VkBool32 largePoints; 
VkBool32 alphaToOne; 
VkBool32 multiViewport; 
VkBool32 samplerAnisotropy; 
VkBool32 textureCompressionETC2; 
VkBool32 textureCompressionASTC_LDR; 
VkBool32 textureCompressionBC; 
VkBool32 occlusionQueryPrecise; 
VkBool32 pipelineStatisticsQuery; 
VkBool32 vertexPipelineStoresAndAtomics; 
VkBool32 fragmentStoresAndAtomics; 
VkBool32 shaderTessellationAndGeometryPointSize; 
VkBool32 shaderlmageGatherExtended; 
VkBool32 shaderStoragelmageExtendedFormats; 
VkBool32 shaderStoragelmageMultisample; 
VkBool32 shaderStoragelmageReadWithoutFormat; 
VkBool32 shaderStoragelmageWriteWithoutFormat; 
VkBool32 shaderUniformBufferArrayDynamicindexing; 
VkBool32 shaderSampledimageArrayDynamicindexing; 
VkBool32 shaderStorageBufferArrayDynamicindexing; 
VkBool32 shaderStoragelmageArrayDynamicindexing; 
VkBool32 shaderClipDistance; 
VkBool32 shaderCullDistance; 
VkBool32 shaderFloat64; 
VkBool32 shaderint64; 
VkBool32 shaderint16; 
VkBool32 shaderResourceResidency; 
VkBool32 shaderResourceMinLod; 
VkBool32 sparseBinding; 
VkBool32 sparseResidencyBuffer; 
VkBool32 sparseResidencylmage2D; 
VkBool32 sparseResidencylmage3D; 
VkBool32 sparseResidency2Samples; 
VkBool32 sparseResidency4Samples; 
VkBool32 sparseResidency8Samples; 
VkBool32 sparseResidency16Samples; 
VkBool32 sparseResidencyAliased; 
VkBool32 variableMultisampleRate; 
VkBool32 inheritedQueries; 

} VkPhysicalDeviceFeatures; 


typedef struct VkPhysicalDeviceFeatures2 { 
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VkStructureType sType; 
void* pNext; 
VkPhysicalDeviceFeatures features; BH 

} VkPhysicalDeviceFeatures2; 

pNext must be NULL or point to one of: 
VkPhysicalDevice16BitStorageFeatures [EU] 
VkPhysicalDeviceMultiviewFeatures 
VkPhysicalDeviceProtectedMemoryFeatures EH 
VkPhysicalDeviceSamplerYcbcrConversionFeatures 
VkPhysicalDeviceShaderDrawParameterFeatures [XF 
VkPhysicalDeviceVariablePointerFeatures 


typedef struct VkPhysicalDevicelDProperties { 
VkStructureType sType; 
void* pNext; 
uint8_t deviceUUID[VK_UUID_SIZE]; 
uint8_t driverUUID[VK_UUID_SIZE]; 
uint8_t deviceLUID[VK_LUID_SIZE]; 
uint32_t deviceNodeMask; 
VkBool32 deviceLUIDValid; 

} VkPhysicalDevicelDProperties; 


typedef struct VkPhysicalDeviceLimits { 

uint32_t maxlmageDimension1D; 

uint32_t maxlmageDimension2D; 

uint32_t maxlmageDimension3D; 

uint32_t maxlmageDimensionCube; 

uint32_t maxlmageArrayLayers; 

uint32_t maxTexelBufferElements; 

uint32_t maxUniformBufferRange; 

uint32_t maxStorageBufferRange; 

uint32_t maxPushConstantsSize; 

uint32_t maxMemoryAllocationCount; 

uint32_t maxSamplerAllocationCount; 

VkDeviceSize bufferlmageGranularity; 

VkDeviceSize sparseAddressSpaceSize; 

uint32_t maxBoundDescriptorSets; 

uint32_t maxPerStageDescriptorSamplers; 

uint32_t maxPerStageDescriptorUniformBuffers; 

uint32_t maxPerStageDescriptorStorageBuffers; 

uint32_t maxPerStageDescriptorSampledimages; 

uint32_t maxPerStageDescriptorStoragelmages; 

uint32_t maxPerStageDescriptorinputAttachments; 

uint32_t maxPerStageResources; 

uint32_t maxDescriptorSetSamplers; 

uint32_t maxDescriptorSetUniformBuffers; 

uint32_t maxDescriptorSetUniformBuffersDynamic; 

uint32_t maxDescriptorSetStorageBuffers; 

uint32_t maxDescriptorSetStorageBuffersDynamic; 

uint32_t maxDescriptorSetSampledimages; 

uint32_t maxDescriptorSetStoragelmages; 

uint32_t maxDescriptorSetinputAttachments; 

uint32_t maxVertexInputAttributes; 

uint32_t maxVertexInputBindings; 

uint32_t maxVertexInputAttributeOffset; 

uint32_t maxVertexInputBindingStride; 

uint32_t maxVertexOutputComponents; 

uint32_t maxTessellationGenerationLevel; 

uint32_t maxTessellationPatchSize; 

uint32_t 

maxtTessellationControlPerVertexInputComponents; 

uint32_t 
maxTessellationControlPerVertexOutputComponents; 

uint32_t 
maxTessellationControlPerPatchOutputComponents; 

uint32_t maxTessellationControlTotalOutputComponents; 

uint32_t maxTessellationEvaluationInputComponents; 

uint32_t maxTessellationEvaluationOutputComponents; 

uint32_t maxGeometryShaderinvocations; 

uint32_t maxGeometrylnputComponents; 

uint32_t maxGeometryOutputComponents; 

uint32_t maxGeometryOutputVertices; 

uint32_t maxGeometryTotalOutputComponents; 

uint32_t maxFragmentinputComponents; 

uint32_t maxFragmentOutputAttachments; 

uint32_t maxFragmentDualSrcAttachments; 

uint32_t maxFragmentCombinedOutputResources; 

uint32_t maxComputeSharedMemorySize; 

uint32_t maxComputeWorkGroupCount{3]; 

uint32_t maxComputeWorkGrouplnvocations; 

uint32_t maxComputeWorkGroupSize[3]; 

uint32_t subPixelPrecisionBits; 

uint32_t subTexelPrecisionBits; 

uint32_t mipmapPrecisionBits; 

uint32_t maxDrawIndexedindexValue; 

uint32_t maxDrawindirectCount; 

float maxSamplerLodBias; 

float maxSamplerAnisotropy; 

uint32_t maxViewports; 

uint32_t maxViewportDimensions[2]; 

float viewportBoundsRange[2]; 

uint32_t viewportSubPixelBits; 

size_t minMemoryMapAlignment; 

VkDeviceSize minTexelBufferOffsetAlignment:; 

VkDeviceSize minUniformBufferOffsetAlignment; 


VkDeviceSize minStorageBufferOffsetAlignment; 

int32_t minTexelOffset; uint32_t maxTexelOffset; 

int32_t minTexelGatherOffset; 

uint32_t maxTexelGatherOffset; 

float mininterpolationOffset; 

float maxinterpolationOffset; 

uint32_t subPixellnterpolationOffsetBits; 

uint32_t maxFramebufferWidth; 

uint32_t maxFramebufferHeight; 

uint32_t maxFramebufferLayers; 

VkSampleCountFlags framebufferColorSampleCounts; [2 

VkSampleCountFlags framebufferDepthSampleCounts; 

VkSampleCountFlags framebufferStencilSampleCounts; 

VkSampleCountFlags 
framebufferNoAttachmentsSampleCounts; [XE] 

uint32_t maxColorAttachments; 

VkSampleCountFlags 
sampledimageColorSampleCounts; 

VkSampleCountFlags 
sampledimagelntegerSampleCounts; 

VkSampleCountFlags 
sampledimageDepthSampleCounts; 

VkSampleCountFlags 
sampledimageStencilSampleCounts; EA 

VkSampleCountFlags storagelmageSampleCounts; [=U] 

uint32_t maxSampleMaskWords; 

VkBool32 timestampComputeAndGraphics; 

float timestampPeriod; 

uint32_t maxClipDistances; 

uint32_t maxCullDistances; 

uint32_t maxCombinedClipAndCullDistances; 

uint32_t discreteQueuePriorities; 

float pointSizeRange[2]; float lineWidthRange[2]; 

float pointSizeGranularity; 

float lineWidthGranularity; 

VkBool32 strictLines; 

VkBool32 standardSampleLocations; 

VkDeviceSize optimalBufferCopyOffsetAlignment; 

VkDeviceSize optimalBufferCopyRowPitchAlignment; 

VkDeviceSize nonCoherentAtomSize; 

} VkPhysicalDeviceLimits; 


typedef struct VkPhysicalDeviceMaintenance3Properties { 
VkStructureType sType; EEE) 
void* pNext; 
uint32_t maxPerSetDescriptors; 
VkDeviceSize maxMemoryAllocationSize; 
} VkPhysicalDeviceMaintenance3Properties; 


typedef struct VkPhysicalDeviceMemoryProperties { 
uint32_t memoryTypeCount; VkMemoryType 
memoryTypes[VK_MAX_MEMORY_TYPES]; EE] 
uint32_t memoryHeapCount; VkMemoryHeap 
memoryHeaps[VK_MAX_MEMORY_HEAPS]; 
} VkPhysicalDeviceMemoryProperties; 


typedef struct VkPhysicalDeviceMultiviewFeatures { 
VkStructureType sType; RA 
void* pNext; 
VkBool32 multiview; 
VkBool32 multiviewGeometryShader; 
VkBool32 multiviewTessellationShader; 
} VkPhysicalDeviceMultiviewFeatures; 


typedef struct VkPhysicalDeviceMultiviewProperties { 
VkStructureType sType; [XI 
void* pNext; 
uint32_t maxMultiviewViewCount; 
uint32_t maxMultiviewinstancelndex; 
} VkPhysicalDeviceMultiviewProperties; 


typedef struct VkPhysicalDevicePointClippingProperties { 
VkStructureType sType; 
void* pNext; 
VkPointClippingBehavior pointClippingBehavior; 
} VkPhysicalDevicePointClippingProperties; 
pointClippingBehavior: 
VK_POINT_CLIPPING_BEHAVIOR_X where X is 
ALL_CLIP_PLANES, USER_CLIP_PLANES ONLY 


typedef struct VkPhysicalDeviceProperties { 
uint32_t apiVersion; uint32_t driverVersion; 
uint32_t vendorID; uint32_t devicelD; 
VkPhysicalDeviceType deviceType; 
char deviceNamel 
VK_MAX_PHYSICAL_DEVICE_NAME_SIZE]; 
uint8_t pipelineCacheUUID[VK_UUID_SIZE]; 
VkPhysicalDeviceLimits limits; 
VkPhysicalDeviceSparseProperties sparseProperties; R9 
} VkPhysicalDeviceProperties; 
deviceType: 
VK_PHYSICAL_DEVICE_TYPE_X where X is 
OTHER, INTEGRATED_GPU, DISCRETE_GPU, 
VIRTUAL_GPU, CPU 
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typedef struct 
VkPhysicalDeviceProtectedMemoryFeatures { 
VkStructureType sType; 
void* pNext; VkBool32 protectedMemory; 
} VkPhysicalDeviceProtectedMemoryFeatures; 


typedef struct 
VkPhysicalDeviceProtectedMemoryProperties { 
VkStructureType sType; 
void* pNext; VkBool32 protectedNoFault; 
} VkPhysicalDeviceProtectedMemoryProperties; 


typedef struct 
VkPhysicalDeviceSamplerYcbcrConversionFeatures { 
VkStructureType sType; 
void* pNext; 
VkBool32 samplerYcbcrConversion; 
} VkPhysicalDeviceSamplerYcbcrConversionFeatures; 


typedef struct 
VkPhysicalDeviceShaderDrawParameterFeatures { 
VkStructureType sType; 
void* pNext; 
VkBool32 shaderDrawParameters; 
} VkPhysicalDeviceShaderDrawParameterFeatures; 


typedef struct VkPhysicalDeviceSparseProperties { 
VkBool32 residencyStandard2DBlockShape; 
VkBool32 residencyStandard2DMultisampleBlockShape; 
VkBool32 residencyStandard3DBlockShape; 
VkBool32 residencyAlignedMipSize; 
VkBool32 residencyNonResidentStrict; 

} VkPhysicalDeviceSparseProperties; 


typedef struct VkPhysicalDeviceSubgroupProperties { 
VkStructureType sType; 
void* pNext; uint32_t subgroupSize; 
VkShaderStageFlags supportedStages; 
VkSubgroupFeatureFlags supportedOperations; 
VkBool32 quadOperationsinAllStages; 

} VkPhysicalDeviceSubgroupProperties; 

supportedOperations: 
VK_SUBGROUP_FEATURE_X_BIT where X is 
ARITHMETIC, BALLOT, BASIC, CLUSTERED, QUAD, SHUFFLE, 
SHUFFLE_RELATIVE, VOTE 


typedef struct VkPhysicalDeviceSurfacelnfo2KHR { 
VkStructureType sType; 
const void* pNext; VkSurfaceKHR surface; 

} VkPhysicalDeviceSurfacelnfo2KHR; 


typedef struct VkPhysicalDeviceVariablePointerFeatures { 
VkStructureType sType; 
void* pNext; 
VkBool32 variablePointersStorageBuffer; 
VkBool32 variablePointers; 
} VkPhysicalDeviceVariablePointerFeatures; 


enum VkPipelineBindPoint: 
VK_PIPELINE_BIND_POINT_COMPUTE, 
VK_PIPELINE_BIND_POINT_GRAPHICS 


enum VkPipelineCreateFlagBits: 
VK_PIPELINE_CREATE_X where X is 
DISABLE_OPTIMIZATION_BIT, 
ALLOW_DERIVATIVES_BIT, 
DERIVATIVE_BIT, 
VIEW_INDEX_FROM_DEVICE_INDEX_BIT, 
DISPATCH_BASE 


typedef struct VkPipelineShaderStageCreatelnfo { 
VkStructureType sType; 
const void* pNext; 
VkPipelineShaderStageCreateFlags flags; E 
VkShaderStageFlagBits stage; 
VkShaderModule module; 
const char* pName; 
const VkSpecializationInfo* pSpecializationinfo; LA 
} VkPipelineShaderStageCreatelnfo; 


typedef struct VkSpecializationInfo { 
uint32_t mapEntryCount; 
const VkSpecializationMapEntry* pMapEntries; EA 
size_t dataSize; const void* pData; 

} VkSpecializationinfo; 


typedef struct VkSpecializationMapEntry { 
uint32_t constantiD; 
uint32_t offset; 
size_t size; 

} VkSpecializationMapEntry; 
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enum VkPipelineStageFlagBits: 
VK_PIPELINE_STAGE_X_BIT where X is 
TOP_OF_PIPE, DRAW_INDIRECT, VERTEX_[INPUT, SHADER], 
TESSELLATION_[CONTROL, EVALUATION]_SHADER, 
[COMPUTE, GEOMETRY, FRAGMENT]_SHADER, 
[EARLY, LATE]_FRAGMENT_ TESTS, 
COLOR_ATTACHMENT_OUTPUT, 
TRANSFER, BOTTOM_OF_PIPE, HOST, 
ALL_{GRAPHICS, COMMANDS} 


typedef struct 
VkPipelineTessellationDomainOriginStateCreatelnfo{ 
VkStructureType sType; 
const void* pNext; 
VkTessellationDomainOrigin domainOrigin; 
} VkPipelineTessellationDomainOriginStateCreatelnfo; 


domainOrigin: 
VK_TESSELLATION_DOMAIN_ORIGIN_UPPER_LEFT 
VK_TESSELLATION_DOMAIN_ORIGIN_LOWER_LEFT 


typedef struct VkProtectedSubmitinfo { 
VkStructureType sType; EEE] 
const void* pNext; VkBool32 protectedSubmit; 
} VkProtectedSubmitinfo; 


enum VkQueryPipelineStatisticFlagBits: 
VK_QUERY_PIPELINE_STATISTIC_X_BIT where X is 
INPUT_ASSEMBLY_{VERTICES, PRIMITIVES}, 
VERTEX_SHADER_INVOCATIONS, 
GEOMETRY_SHADER_{INVOCATIONS, PRIMITIVES}, 
CLIPPING_{INVOCATIONS, PRIMITIVES}, 
FRAGMENT_SHADER_INVOCATIONS, 
TESSELLATION_CONTROL_SHADER_PATCHES, 
TESSELLATION_EVALUATION_SHADER_INVOCATIONS, 
COMPUTE_SHADER_INVOCATIONS 


typedef struct VkRect2D { 
VkOffset2D offset; 
VkExtent2D extent; 
} VkRect2D; 


typedef struct 
VkRenderPassinputAttachmentAspectCreatelnfo { 
VkStructureType sType; 
const void* pNext; uint32_t aspectReferenceCount; 
const VkInputAttachmentAspectReference* 
pAspectReferences; [FE] 
} VkRenderPassInputAttachmentAspectCreatelnfo; 


typedef struct VkRenderPassMultiviewCreatelnfo { 
VkStructureType sType; [XI 
const void* pNext; uint32_t subpassCount; 
const uint32_t* pViewMasks; 
uint32_t dependencyCount; 
const int32_t* pViewOffsets; 
uint32_t correlationMaskCount; 
const uint32_t* pCorrelationMasks; 
}VkRenderPassMultiviewCreatelnfo; 


enum VkSampleCountFlagBits: 


VK_SAMPLE_COUNT_X_BIT where X is 
1, 2, 4, 8, 16, 32, 64 


typedef struct 
VkSamplerYcbcrConversionimageFormatProperties { 
VkStructureType sType; EEE] 
void* pNext; 
uint32_t combinedImageSamplerDescriptorCount; 
} VkSamplerYcbcrConversionimageFormatProperties; 


typedef struct VkSamplerYchcrConversioninfo { 
VkStructureType sType; BA 
const void* pNext; 
VkSamplerYcbcrConversion conversion; 

} VkSamplerYcbcrConversionInfo 


enum VkShaderStageFlagBits: 
VK_SHADER_STAGE_X where X is 
{VERTEX, GEOMETRY, FRAGMENT, COMPUTE} BIT, 
TESSELLATION_CONTROL_BIT, 
TESSELLATION_EVALUATION_BIT, 
ALL_GRAPHICS, ALL 


enum VkSharingMode: 


VK_SHARING_MODE_EXCLUSIVE, 
VK_SHARING_MODE_CONCURRENT 


typedef struct VkSparseMemoryBind { 
VkDeviceSize resourceOffset;VkDeviceSize size; 


VkDeviceMemory memory; VkDeviceSize memoryOffset; 


VkSparseMemoryBindFlags flags; 
} VkSparseMemoryBind; 


flags: VK_SPARSE_MEMORY_BIND_METADATA_BIT 


VkStructureType 
The name of each VkStructureType value is obtained by 
taking the name of the structure, stripping the leading 
Vk, prefixing each capital letter with _, converting the 
entire resulting string to upper case, and prefixing it 
with VK_STRUCTURE_TYPE_. 


typedef struct VkSurfaceCapabilitiesKHR { 
uint32_t minlmageCount; 
uint32_t maximageCount; 
VkExtent2D currentExtent; D 
VkExtent2D minimageExtent; EA 
VkExtent2D maxlmageExtent; 
uint32_t maxlmageArrayLayers; 
VkSurfaceTransformFlagsKHR supported Transforms; 
VkSurfaceTransformFlagBitsKHR currentTransform; 
VkCompositeAlphaFlagsKHR 
supportedCompositeAlpha; 
VkImageUsageFlags supportedUsageFlags; 
} VkSurfaceCapabilitiesKHR; 
enum VkCompositeAlphaFlagBitsKHR: 
VK_COMPOSITE_ALPHA_X_BIT_KHR where X is 
OPAQUE, PRE_MULTIPLIED, POST_MULTIPLIED, INHERIT 


typedef struct VkSurfaceFormatKHR { 
VkFormat format; 
VkColorSpaceKHR colorSpace; 
} VkSurfaceFormatKHR; 


colorSpace: VK_COLOR_SPACE_SRGB_NONLINEAR_KHR 


enum VkSurfaceTransformFlagBitsKHR { 
VK_SURFACE_TRANSFORM_X_BIT_KHR where X is 
IDENTITY, 
ROTATE_{90, 180, 270}, 
HORIZONTAL_MIRROR 
HORIZONTAL_MIRROR_ROTATE_{90, 180, 270}, 
INHERIT 


typedef struct VkViewport { 

float x; float y; 

float width; float height; 

float minDepth; float maxDepth; 
} VkViewport; 


Learn more about Vulkan 

Vulkan is maintained by the Khronos Group, a worldwide 
consortium of organizations that work to create and maintain 
key standards used across many industries. Visit Khronos 
online for resources to help you use and master Vulkan: 


Main Vulkan Resource Page: khronos.org/vulkan/ 
Vulkan Registry: khronos.org/registry/vulkan/ 
Forums: forums.khronos.org/ 

Courses: khronos.org/developers/training/ 
Videos & Presentations: khr.io/library/ 

Khronos Events: khronos.org/news/events/ 
Khronos Blog: khronos.org/blog/ 

Reference Guides: khr.io/refguides/ 

Khronos Books: khronos.org/developers/books/ 


Khronos Merchandise: khronos.org/store/ 
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@thekhronosgroup 


khronos.org 


www.khronos.org/vulkan 
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Vulkan Reference Guide Index 


The following index shows each item included on this card along with the page on which it is described. The color of the row in the table below is the color of the pane to which you should refer. 


A-G 

Android Platform 
Blending 

Buffers 

Cache Control 

Clear Commands 
Command Buffers 
Command Funciton Pointers 
Command Pools 
Compute Pipelines 

Copy Commands 

Depth Bias 

Depth Bounds 
Descriptors, Resource 
Devices 

Dispatching Commands 
Display Enumeration 
Drawing Commands 
Enumerations 

Events 

Extensions 

Fences 

Format Properties 
Fragment Operations 
Framebuffers 

Graphics Pipelines 

I-R 

Image Capabilities 

Image Views 

Images 

Instances 

Layers 

Line Width 

Memory Allocation 
Pipeline Barriers 

Pipeline Layouts 
Pipelines 

Queries 

Queues 

Rasterization 

Render Pass 

Resource Creation 
Resource Descriptors 
Return Codes 

S-V 

Samplers 

Scissor Test 

Semaphores 

Shaders 

Sparse Resources 

Stencil Test 

Structures 
Synchronization 
Timestamp Queries 
Variables, Built-in 

Vertex Input Description 
Viewport 

vkA - vkCl 
vkAcquireNextimage* 
VkAcquireNextimagelnfoKHR 
vkAllocateCommandBuffers 
vkAllocateDescriptorSets 
vkAllocate Memory 
VkAndroidSurfaceCreatelnfoKHR 
VkApplicationinfo 
VkAttachment* 
vkBeginCommandBuffer 
vkBind{Buffer, Image}Memory* 
VkBindimageMemoryinfo 
VkBindSparselnfo 
VkBuffer[Image]Copy 
VkBuffer[View]Createlnfo 
VkBufferMemoryRequirementsinfo2 
VkClear{Attachment, Rect} 


Re) bs 


an 
© (D 00 H “ co 0 © W æ #3 ND do N U1 DO 


Ww 
worn hone o 


= 
= 


NDUBDODAANWHPEOBRINN 


vkCmaBindPipeline 
vkCmdBindVertexBuffers 
vkCmdBlitimage 
vkCmdClearAttachments 
vkCmdClearColorimage 
vkCmdClearDepthStencillmage 
vkCmdCopyBuffer[Tolmage] 
vkCmdCopylmage[ToBuffer] 
vkCmdCopyQueryPoolResults 
vkCmdDispatch* 
vkCmdDraw[Indirect] 
vkCmdDrawIndexed[Indirect] 
vkCmdEndQuery 
vkCmdEndRenderPass 
vkCmdExecuteCommands 
vkCmdFillBuffer 
vkCmdNextSubpass 
vkCmdPipelineBarrier 
vkCmdPushConstants 
vkCmdResetQueryPool 
vkCmdResolvelmage 
vkCmdSetBlendConstants 
vkCmdSetDepthBias 
vkCmdSetDepthBounds 
vkCmdSetDeviceMask 
vkCmdSetLineWidth 
vkCmdSetScissor 


vkCmdSetStencil{Compare, Write}Mask 


vkCmdSetStencilReference 
vkCmdSetViewport 
vkCmdUpdateBuffer 
vkCmdWaitEvents 
vkCmdWriteTimestamp 


VkCo - vkCr 
VkCommandBuffer* 
VkCommandPoolCreatelnfo 
VkComponentMapping 
VkComputePipelineCreatelnfo 
VkCopyDescriptorSet 
vkCreate{Event, Fence} 
vkCreateAndroidSurfaceKHR 
vkCreateBuffer[View] 
vkCreateCommandPool 
vkCreateComputePipelines 
vkCreateDescriptorPool 
vkCreateDescriptorSetLayout 
vkCreateDescriptorUpdateTemplate 
vkCreateDevice 
vkCreateDisplayModeKHR 
vkCreateDisplayPlaneSurfaceKHR 
vkCreateFramebuffer 
vkCreateGraphicsPipelines 
vkCreatelmage 
vkCreatelmageView 
vkCreatelnstance 
vkCreatePipelineCache 
vkCreatePipelineLayout 
vkCreateQueryPool 
vkCreateRenderPass 
vkCreateSampler[YcbcrConversion] 
vkCreateSemaphore 
vkCreateShaderModule 
vkCreateSharedSwapchainsKHR 
vkCreateSwapchainKHR 
vkCreateWaylandSurfaceKHR 
vkCreateWin32SurfaceKHR 
vkCreateXcbSurfaceKHR 
vkCreateXlibSurfaceKHR 


VkDesc - vkDest 
VkDescriptor{Buffer, Image}Info 
VkDescriptorPool* 
VkDescriptorSetAllocatelnfo 
VkDescriptorSetLayoutSupport 


NN œ Co 00 Co 00 Go N © © 00 00 Ny NNW N Ww N © © O N DO O0 I J I 00 Co A 


2 
1 
6 
3 
T 
2 
9 
5 
il 
3 
6 
6 
7 
1 
9 
9 
3 
3 
5 
6 
1 
4 
6 
7 
3 
6 
2 
3 


Be 
STS) 


vkDestroyDevice 
vkDestroyFramebuffer 
vkDestroylmage[View] 
vkDestroylnstance 
vkDestroyPipeline[Cache] 
vkDestroyPipelineLayout 
vkDestroyQueryPool 
vkDestroyRenderPass 
vkDestroySampler[YcbcrConversion] 
vkDestroySemaphore 
vkDestroyShader Modul 
vkDestroySurfaceKHR 
vkDestroySwapchainKH 


VkDev - vkF 
VkDevice[GroupDevice]Createlnfo 
VkDeviceGroupPresentCapabilitiesKHR 
VkDeviceGroupPresentInfoKHR 
VkDeviceGroupSwapchainCreatelnfoKHR 
VkDeviceQueue[Create]|nfo* 
vkDeviceWaitldle 
VkDispatchindirectCommand 
VkDisplayMode* 

VkDisplayPlane* 
VkDisplayPresentInfoKHR 
VkDisplayPropertiesKHR 
VkDisplaySurfaceCreatelnfoKHR 
VkDraw([Indexed]IndirectCommand 
vkEndCommandBuffer 
vkEnumerateDevice* 
vkEnumeratelnstance* 
vkEnumeratelnstanceVersion 
vkEnumeratePhysicalDevice* 
Vk{Event, Fence}Createlnfo 
VkExtensionProperties 
VkExternalBufferProperties 
VkExternalFenceProperties 
VkExternalSemaphoreProperties 
vkFlushMappedMemoryRanges 
VkFormatProperties* 
VkFramebufferCreatelnfo 
vkFreeCommandBuffers 
vkFreeDescriptorSets 

vkFreeMemory 


vkG 

vkGet{Event, Fence}Status 
vkGetBufferMemoryRequirements* 
vkGetDescriptorSetLayoutSupport 
vkGetDeviceGroupPeerMemoryFeatures 
vkGetDeviceGroupPresentCapabilitiesKHR 
vkGetDeviceGroupSurfacePresentModesKHR 
vkGetDeviceMemoryCommitment 
vkGetDeviceProcAddr 
vkGetDeviceQueue* 
vkGetDisplayModePropertiesKHR 
vkGetDisplayPlaneCapabilitiesKHR 
vkGetDisplayPlaneSupportedDisplaysKHR 
vkGetimageMemoryRequirements* 
vkGetimageSparseMemoryRequirements* 
vkGetimageSubresourceLayout 
vkGetInstanceProcAddr 


vkGetPhysicalDeviceDisplay[Plane]PropertiesKHR 


vkGetPhysicalDeviceExternalBufferProperties 
vkGetPhysicalDeviceExternalFenceProperties 


vkGetPhysicalDeviceExternalSemaphoreProperties 


vkGetPhysicalDeviceFeatures* 
vkGetPhysicalDeviceFormatProperties* 
vkGetPhysicalDevicelmageFormatProperties* 
vkGetPhysicalDeviceMemoryProperties* 
vkGetPhysicalDevicePresentRectanglesKHR 
vkGetPhysicalDeviceProperties* 
vkGetPhysicalDeviceQueueFamilyProperties* 
vkGetPhysicalDeviceSparselmageFormat* 
vkGetPhysicalDeviceSurface* 
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vkGetPhysicalDeviceWaylandPresentationSupport* 10 


VkGr-VkP 
VkGraphicsPipelineCreatelnfo 
VkimageBlit 

VkimageCopy 

VklmageCreatelnfo 
VkimageFormatProperties* 
VkimageMemoryRequirementsinfo2 
VkimageResolve 
VkimageSparseMemoryRequirementsinfo2 
VklmageSubresource 
VkimageSwapchainCreatelnfoKHR 
VkimageViewCreatelnfo 
VklnstanceCreatelnfo 
vkinvalidateMappedMemoryRanges 
VkLayerProperties 

vkMapMemory 
VkMappedMemoryRange 
VkMemoryAllocatelnfo 
vkMergePipelineCaches 
VkPhysicalDeviceExternalBufferinfo 
VkPhysicalDeviceExternalFencelnfo 
VkPhysicalDeviceExternalSemaphorelnfo 
VkPhysicalDevice[Group]Properties* 
VkPhysicalDevicelmageFormatinfo2 
VkPhysicalDeviceMemoryProperties2 
VkPhysicalDeviceSparselmageFormatinfo2 
VkPipelineCacheCreatelnfo 
VkPipelineColorBlend* 
VkPipelineDepthStencilStateCreatelnfo 
VkPipelineDynamicStateCreatelnfo 
VkPipelinelnputAssemblyStateCreatelnfo 
VkPipelineLayoutCreatelnfo 
VkPipelineMultisampleStateCreatelnfo 
VkPipelineRasterizationStateCreatelnfo 
VkPipelineTessellationStateCreatelnfo 
VkPipelineVertexInputStateCreatelnfo 
VkPipelineViewportStateCreatelnfo 


VkPr-VkSt 

VkPresentinfoKHR 
VkPresentRegion[s]KHR 
VkPushConstantRange 
VkQueryPoolCreatelnfo 
vkQueueBindSparse 
VkQueueFamilyProperties* 
vkQueuePresentKHR 
vkQueueSubmit 

vkQueueWaitidle 
VkRectLayerKHR 
VkRenderPass{Begin, Create}Info 
vkResetCommandBuffer 
vkResetCommandPool 
vkResetDescriptorPool 
vkResetFences 
VkSampler[YcbcrConversion]Createlnfo 
VkSemaphoreCreatelnfo 

vk{Set, Reset}Event 
VkShaderModuleCreatelnfo 
VkSharedPresentSurfaceCapabilitiesKHR 
VkSparseBufferMemoryBindInfo 
VkSparselmageFormatProperties* 
VkSparselmage[Opaque]Memory* 
VkStencilOpState 

VkSu - W 

VkSubmitinfo 

VkSubpass* 

VkSubresourceLayout 

VkSurface* 
VkSwapchainCreatelnfoKHR 
vkTrimCommandPool 
vkUnmapMemory 
vkUpdateDescriptorSet* 
VkVertexInputAttributeDescription 
VkVertexInputBindingDescription 
vkWaitForFences 
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VkDescriptorUpdateTemplate* 
vkDestroy{Event, Fence} 
vkDestroyBuffer[View] 
vkDestroyCommandPool 
vkDestroyDescriptorPool 
vkDestroyDescriptorSetLayout 
vkDestroyDescriptorUpdateTemplate 
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VkWaylandSurfaceCreatelnfoKHR 
VkWin32SurfaceCreatelnfoKHR 
VkWriteDescriptorSet 
VkXcbSurfaceCreatelnfoKHR 
VkXlibSurfaceCreatelnfoKHR 
Wait Idle Operations 

WSI (Window System Integration) 


vkGetPhysicalDeviceWin32PresentationSupport* 10 
vkGetPhysicalDeviceXcbPresentationSupportKHR 10 
vkGetPhysicalDeviceXlibPresentationSupportKHR 10 
vkGetPipelineCacheData 4 
vkGetQueryPoolResults 

vkGetRenderAreaGranularity 

vkGetSwapchain* 


vkCm 

vkCmd{Set, Reset}Event 
vkCmdBeginQuery 
vkCmdBeginRenderPass 
vkCmdBindDescriptorSets 
vkCmdBindindexBuffer 


NOON OONWAN BHR 


Vulkan is a registered trademark of the Khronos Group. The Khronos Group is an industry 
consortium creating open standards for the authoring and acceleration of parallel 
computing, graphics and dynamic media on a wide variety of platforms and devices. 


See www.khronos.org to learn more about the Khronos Group. 
See www.khronos.org/vulkan to learn more about Vulkan. 
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